---
title: "Send, save, or send a saved MMS"
method: POST
path: "/"
tags: ["MMS"]
---

# Send, save, or send a saved MMS

`POST /`

This request is used to send, save, or send a saved MMS message.

## Request body

- union — This request is used to send, save, or send a saved MMS message.
  - object — This is to send an MMS.
    - `action` 'sendmms', required — The action for this API request. In this case, to send an MMS.
    - `service-id` string, required — The ID of the campaign.
    - `to` string, required — Destination phone number with country code.
    - `from` string, required — Shortcode, or Toll Free, or 10DLC with country code.
    - `from-mask` string — Only carriers in certain countries allow Alphanumeric senders. Not supported in the USA.
    - `message-subject` string — MMS subject text. Limit to 40 characters for best deliverability. Maximum of 80 characters.
    - `fallback-sms-text` string — Must be included if `disable-fallback-sms` is set to `false`. Text to be included when SMS sent as a fallback. For best deliverability, limit string to 110 characters.
    - `disable-fallback-sms-link` boolean — Set to `true` to prevent a link to the MMS content from being included in the SMS fallback message.
    - `disable-fallback-sms` boolean — Set to `true` to prevent delivery of fallback SMS message.
    - `fallback-sms-link-expiration` string, date-time — Expiration for the SMS fallback link. If not populated, defaults to 1 year from the time and date at which the API request was made. Maximum of 1 year. Accepts ISO8601 Date format. Only applies to fallback SMS messages.
    - `mms-expiry-timestamp` string, date-time — MMS delivery attempts will stop after the date and time specified in this field. If the MMS is already delivered to the device, it will remain in the device's inbox. If not populated, the expiration value defaults to 3 days from the time and date at which the API request was made. Maximum of 3 days. Accepts ISO8601 Date format.
    - `client-reference` string — Customer transaction ID of the request. Passed back in all postbacks for this transaction. Maximum length of 64 characters.
    - `cache-content` boolean — Caching is done for every `sendmms` request by default unless overridden by the API request by populating this field with `false`. If cache is found, the original content won't be downloaded to validate.
    - `slide` union[], required — Slide content node which contains the content URL. Must contain at least one slide object. A maximum of 8 slides may be specified for a single MMS message. Acceptable slide content includes: - `image` (cannot be used with `video`, `contact`, `calendar`, or `pdf`) - `audio` (cannot be used with `video`, `contact`, `calendar`, or `pdf`) - `video` (cannot be used with `image`, `audio`, `contact`, `calendar`, or `pdf`) - `contact` (cannot be used with `image`, `audio`, or `video`) - `calendar` (cannot be used with `image`, `audio`, or `video`) - `pdf` (cannot be used with `image`, `audio`, or `video`) - `message-text` (maximum of 5000 characters) Note that you cannot include multiple files of the same MIME type on the same slide. Also note that, if transcoding is `ON` for the account, the API shall reformat the content when necessary, so it can be delivered to the end-users handset in the best possible way.
      - union
        - object — Supports .jpg (image/jpg, image/jpeg), .png (image/png), and .gif (image/gif).
          - `image` object
            - `url` string — Public content URL where the image is accessible.
          - `message-text` string — Text that is delivered alongside the content if added in a slide of the MMS. Supports plain text. Maximum of 5000 characters.
        - object — Supports .mp3 (audio/mp3, audio/mpeg), .wav (audio/x-wave, audio/x-wav), and .am (audio/amr).
          - `audio` object
            - `url` string — Public content URL where the audio file is accessible.
          - `message-text` string — Text that is delivered alongside the content if added in a slide of the MMS. Supports plain text. Maximum of 5000 characters.
        - object — Supports .mp4 (video/mp4), .mpg or .mpeg (video/mpeg), .avi (video/x-msvideo), .wmv (video/x-ms-wmv), .mov (video/quicktime), and .3gp (video/3gpp).
          - `video` object
            - `url` string — Public content URL where the video is accessible.
          - `message-text` string — Text that is delivered alongside the content if added in a slide of the MMS. Supports plain text. Maximum of 5000 characters.
        - object — Supports .vcf and .vcard (text/vcard, text/v-card, text/x-vcard).
          - `contact` object
            - `url` string — Public content URL where the contact card is accessible.
          - `message-text` string — Text that is delivered alongside the content if added in a slide of the MMS. Supports plain text. Maximum of 5000 characters.
        - object — Supports .ics, .ical, .ifb, and .icalendar (text/calendar).
          - `calendar` object
            - `url` string — Public content URL where the calendar is accessible.
          - `message-text` string — Text that is delivered alongside the content if added in a slide of the MMS. Supports plain text. Maximum of 5000 characters.
        - object — Supports .pdf (application/pdf, application/x-pdf).
          - `pdf` object
            - `url` string — Public content URL where the PDF is accessible.
          - `message-text` string — Text that is delivered alongside the content if added in a slide of the MMS. Supports plain text. Maximum of 5000 characters.
  - object — This is to save an MMS.
    - `action` 'savemms', required — The action for this API request. In this case, the action stores the MMS defined in the JSON.
    - `message-subject` string — MMS subject text. Limit to 40 characters for best deliverability. Maximum of 80 characters.
    - `fallback-sms-text` string — Text which gets sent when MMS is sent as SMS fallback. Limit text to 110 characters for best deliverability.
    - `disable-fallback-sms` boolean — If set to true, this disables the SMS fallback.
    - `disable-fallback-sms-link` boolean — If set to true, this disables appending a link to the MMS Content at the end of the SMS fallback text.
    - `fallback-sms-link-expiration` string — Expiration for SMS fallback link. If not passed, it is defaulted to 1 year from the date of this API request being made. The maximum duration is 1 year. Accepts ISO8601 Date format. Applies to only fallback SMS.
    - `client-reference` string — Customer transaction ID of the request. Passed back in all postbacks for this transaction. Maximum length of 64 characters.
    - `name` string, required — MMS template name for internal reference only.
    - `slide` union[] — Slide content node which contains the content URL. Must contain at least one slide object. A maximum of 8 slides may be specified for a single MMS message. Acceptable slide content includes: - `image` (cannot be used with `video`, `contact`, `calendar`, or `pdf`) - `audio` (cannot be used with `video`, `contact`, `calendar`, or `pdf`) - `video` (cannot be used with `image`, `audio`, `contact`, `calendar`, or `pdf`) - `contact` (cannot be used with `image`, `audio`, or `video`) - `calendar` (cannot be used with `image`, `audio`, or `video`) - `pdf` (cannot be used with `image`, `audio`, or `video`) - `message-text` (maximum of 5000 characters) Note that you cannot include multiple files of the same MIME type on the same slide. Also note that, if transcoding is `ON` for the account, the API shall reformat the content when necessary, so it can be delivered to the end-users handset in the best possible way.
      - union
        - object — Supports .jpg (image/jpg, image/jpeg), .png (image/png), and .gif (image/gif).
          - `image` object
            - `url` string — Public content URL where the image is accessible.
          - `message-text` string — Text that is delivered alongside the content if added in a slide of the MMS. Supports plain text. Maximum of 5000 characters.
        - object — Supports .mp3 (audio/mp3, audio/mpeg), .wav (audio/x-wave, audio/x-wav), and .am (audio/amr).
          - `audio` object
            - `url` string — Public content URL where the audio file is accessible.
          - `message-text` string — Text that is delivered alongside the content if added in a slide of the MMS. Supports plain text. Maximum of 5000 characters.
        - object — Supports .mp4 (video/mp4), .mpg or .mpeg (video/mpeg), .avi (video/x-msvideo), .wmv (video/x-ms-wmv), .mov (video/quicktime), and .3gp (video/3gpp).
          - `video` object
            - `url` string — Public content URL where the video is accessible.
          - `message-text` string — Text that is delivered alongside the content if added in a slide of the MMS. Supports plain text. Maximum of 5000 characters.
        - object — Supports .vcf and .vcard (text/vcard, text/v-card, text/x-vcard).
          - `contact` object
            - `url` string — Public content URL where the contact card is accessible.
          - `message-text` string — Text that is delivered alongside the content if added in a slide of the MMS. Supports plain text. Maximum of 5000 characters.
        - object — Supports .ics, .ical, .ifb, and .icalendar (text/calendar).
          - `calendar` object
            - `url` string — Public content URL where the calendar is accessible.
          - `message-text` string — Text that is delivered alongside the content if added in a slide of the MMS. Supports plain text. Maximum of 5000 characters.
        - object — Supports .pdf (application/pdf, application/x-pdf).
          - `pdf` object
            - `url` string — Public content URL where the PDF is accessible.
          - `message-text` string — Text that is delivered alongside the content if added in a slide of the MMS. Supports plain text. Maximum of 5000 characters.
  - object — This is to send a saved MMS.
    - `action` 'sendsavedmms', required — The action for this API request. In this case, the API sends the saved MMS Template from a specified account, using an MMSID, to a single mobile number.
    - `mms-id` string, required — The ID of the MMS template.
    - `service-id` string, required — The ID of the campaign.
    - `to` string, required — Destination phone number with country code.
    - `from` string, required — Shortcode, or Toll Free, or 10DLC with country code.
    - `from-mask` string — Only carriers in certain countries allow Alphanumeric senders. Not supported in the USA.
    - `message-subject` string — MMS subject text. Limit to 40 characters for best deliverability. Maximum of 80 characters.
    - `fallback-sms-text` string — Mandatory if `disable-fallback-sms` is set to `false`. Text which is sent when message is sent as SMS fallback. Overrides the setting saved in the MMS template. Limit the number of characters used in the text to between 20 and 110 characters for best results.
    - `disable-fallback-sms` boolean — Set to `true` to disable the SMS fallback. Overrides the setting saved in the MMS Template.
    - `disable-fallback-sms-link` boolean — Set to `true` to disable appending a link to the MMS content at the end of the SMS fallback text. Overrides the setting saved in the MMS Template.
    - `fallback-sms-link-expiration` string, date-time — Expiration for the SMS fallback link. If not populated, defaults to 1 year from the time and date at which the API request was made. Maximum of 1 year. Accepts ISO8601 Date format. Only applies to fallback SMS messages.
    - `mms-expiry-timestamp` string, date-time — MMS delivery attempts will stop after the date and time specified in this field. If the MMS is already delivered to the device, it will remain in the device's inbox. If not populated, the expiration value defaults to 3 days from the time and date at which the API request was made. Maximum of 3 days. Accepts ISO8601 Date format.
    - `client-reference` string — Customer transaction ID of the request. Passed back in all postbacks for this transaction. Maximum length of 64 characters.
    - `custom-slides` object[] — Custom slides to dynamically replace the text of already specified slides at the time of sending.
      - `custom-message-text` string — Any existing text in the slide of the message specified in `custom-slide` will be replaced with this text.
      - `custom-slide` string — Slide number identifying which slide's text content to replace with `custom-message-text`.

## Response `200`

Response

- ResponsePayload
  - `status` 'success' | 'failure' — Indicates the status of the action. Either `success` or `failure`.
  - `status-details` string — More details about the status of the action. Returned with `success` status for any action.
  - `tracking-id` string — Transaction ID for the request. Used for identifying postbacks received for this API request. Returned with `success` status for any action.
  - `to` string — Destination phone number with country code. Returned when `sendmms` or `sendsavedmms` have a `success` status.
  - `mms-id` string — The ID of the sent MMS template. Returned when `sendsavedmms` has a `success` status.
  - `from` string — Shortcode or Toll Free/10DLC number with country code that will be used to send a saved MMS. Returned when `sendsavedmms` has a `success` status.
  - `error-code` string — Code that identifies the specific error that was encountered. Returned with `failure` status for any action.
  - `error-info` string — Message that explains the error code. Returned with `failure` status for any action.

---

[API](https://skmtc.net/sinch/apis/sinch-messaging-and-content-apis-sinch.md) · [All operations](https://skmtc.net/sinch/apis/sinch-messaging-and-content-apis-sinch/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinch/sinch-messaging-and-content-apis-sinch/revisions/2b7c81dfeed6/schema)