---
title: "Send a message (Chat)"
method: POST
path: "/domains/{domain}/users/{user}/messagesessions/{messagesession}/messages"
tags: ["Messages"]
---

# Send a message (Chat)

`POST /domains/{domain}/users/{user}/messagesessions/{messagesession}/messages`

## Request

- Base URL: `https://ns-api.com/ns-api/v2`
- URL: `https://ns-api.com/ns-api/v2/domains/{domain}/users/{user}/messagesessions/{messagesession}/messages`
- Auth: HTTP bearer

## Path parameters

- `domain` string, required: This is the main organization name. This is used to link resource to its group/tenant/organization/enterprise. Then using in path for GET you can set to "~" to use the domain name linked to your token/key instead of the domain name itself when reading for your own domain.
- `user` string, required: This is the main user extension for the user account. ~ can be used to mean "my account" which will extract the user from the token/key used for authentication.
- `messagesession` string, required

## Request body

- object
  - `type` string, required
  - `message` string, required: This is the text that will be sent as the message
  - `destination` union, required: This is a single user or phonenumber for chat and SMS respectively. If sending to multiple recipients, then should be an array of users or phonenumbers
    - string: A single domain user or phonenumber
    - string[]: An array of domain users or phonenumbers in string format
  - `from-number` string: This is used only for SMS. This is the user's number used to send outbound for SMS
  - `data` string, nullable: This is used only for media chat or MMS. This is the base64 data of the media file to be sent
  - `mime-type` string
  - `size` integer, nullable: This is used only for media chat or MMS. This is the size in bytes of the media file being sent

## Response `202`

- object
  - `code` integer, required
  - `message` string, required

## Changes

- **2026-11-03** `bce16087d479`: 3 info
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `404`

[Operation history](https://skmtc.dev/ns-api/apis/netsapiens-api-v2/changes/domains/:domain/users/:user/messagesessions/:messagesession/messages/post.md)

---

[API](https://skmtc.dev/ns-api/apis/netsapiens-api-v2.md) - [All operations](https://skmtc.dev/ns-api/apis/netsapiens-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/ns-api/apis/netsapiens-api-v2/revisions/bce16087d479?raw)