---
title: "Send MMS"
method: POST
path: "/v2/mms"
tags: ["MMS"]
---

# Send MMS

`POST /v2/mms`

The Send MMS endpoint allows you to send multimedia messages (MMS) to recipients.

## Request body

- MMSSendRequest
  - `subject` string — Subject of the message. Maximum length of 20 characters.
  - `message` string — Body text of the message. Maximum length of 1,000 characters. If opt-out is required, insert parameter [opt-out-link] into the message and a link will be generated.
  - `message_ref` string — A reference supplied by your system. Maximum length of 500 characters. This reference will be passed back in webhooks so that you can relate events to messages you sent. For example, being able to relate a Link Hit event to a specific sent message.
  - `sender` string, required — The sender is the number that shows recipients who sent the message.
  - `recipient` string, required — The destination number for delivery. Can be either in local format or in international format. For international format, it should follow E.164 standard. [http://en.wikipedia.org/wiki/E.164](http://en.wikipedia.org/wiki/E.164) Can only send to Australia currently. Examples of conversions to E.164 format: Australia 0438 333 061 => 61438333061
  - `content_urls` string[], required — Specify a list of URLs of the media file(s) that you are trying to send. Supported file formats include jpg, gif, png, MP3, and video MP4. Only one image up to 400 KB can be attached at a time. URLs must be absolute paths to the media file, they cannot be relative paths. For example, https://outbound-mms.smsbump.com/2024/fashion.gif.
  - `track_links` boolean — Enable the link tracking feature which replaces links in outbound messages with shortened links. This allows us to track when recipients view links.
  - `is_sandbox` boolean — Deprecated. Will be removed in a future version.

## Response `200`

OK

- MMSResponse — MMS message details.
  - `id` string, required — Unique identifier for the MMS message.
  - `recipient` string, required — The destination number for delivery.
  - `sender` string, required — The sender number.
  - `country` string, required — Country code.
  - `subject` string, required — Subject of the message.
  - `message` string, required — Body text of the message.
  - `message_ref` string, required — Reference supplied by your system.
  - `content_urls` string[], required — List of media file URLs.
  - `status` string, required — Status of the message.
  - `track_links` boolean, required — Whether link tracking is enabled.
  - `is_sandbox` boolean, required — Deprecated. Will be removed in a future version.
  - `created_at` string, date-time, required — Timestamp when the MMS was created.
  - `updated_at` string, date-time, required — Timestamp when the MMS was last updated.

---

[API](https://skmtc.net/kudosity/apis/transmit-message-api.md) · [All operations](https://skmtc.net/kudosity/apis/transmit-message-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kudosity/transmit-message-api/versions/bf132756e067/schema)