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

# Send a message (MMS)

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

> Note: # and anything after is NOT needed, its just to allow multiple examples for the same path/method.

## 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

- MessageSend
  - `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

## Other responses

- `400`
- `401`
- `404`

---

[API](https://skmtc.net/ns-api/apis/netsapiens-api-v2.md) · [All operations](https://skmtc.net/ns-api/apis/netsapiens-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ns-api/netsapiens-api-v2/revisions/d37f65b5b886/schema)