# sendMMS

Send an MMS that has been defined in XML. Read more.

## Overview

Sends an MMS defined in the XML containing slides of embedded with video, audio, images and/or text to a single number in international number format. The sendMMS is a minor extension of the saveMMS function. Note, while elements may be given in any order, the slides are created in the order given in the API call.

While the sendMMS API method allows sending slides containing video elements, it's not recommended as it introduces latency during the call. Therefore, Sinch suggests strongly that you use the saveMMS API call to submit video content and then Sinch MMS service can transcode the contents in advance before you request the sendSavedMMS API call.

If the sendMMS API is used to send the same content to multiple users, at present the Sinch application doesn't cache this content as such the content will need to be uploaded for each request. This is another reason Sinch suggests that you use combination of saveMMS and sendSavedMMS API calls.

The mandatory parameter ‘fallback-sms-text’ sets the text that's sent if the MMS is delivered via an SMS link. Additionally, if the MMS is delivered via an SMS link, the ‘fallback-sms-link-expiration’ parameter can be used to expire the original MMS link. The content on the MMS link is disabled on the date defined by the parameter. By default, it expires 365 days from the date the original MMS was created.

 Important:
Sinch will send an HTTP GET request to the server that is specified in the XML slide of the embedded images, videos, audios, and/or other object URIs to retrieve the contents of the media file. The HTTP response header Sinch receives from the server MUST contain the `Content-Length` field indicating the size of the resource. Otherwise, the API request will fail. Customers using CDNs that employ chunked transfer encoding may run into problems in which the server returns a `Transfer-Encoding` field with a value of "chunked" specified in the HTTP GET response, rather than the server returning `Content-Length`. If a `Transfer-Encoding` field with a value of "chunked" is specified in an HTTP, the API request will be rejected.

 Important:
All media files are expected to serve a valid content-type header (for example, text/plain, image/gif, audio/mp3, video/mp4, etc.). If a file server serves a file using the application/octet-stream content-type header instead, it may be rejected if the MIME type cannot be determined by other means.

**Request Parameters:**

> Mandatory: action, api_key, to, from, name, slide, fallback-sms-text, service-id
Optional: operatorid, campaignRef, message-subject, image, audio, video, url, text, duration, vcard, ical, pdf, passbook, message-text, fallback-sms-link-expiration


**Response Parameters:**

> status, to, mmsId, trackingId, errorCode, errorInfo


**Related Error Codes:**

> All saveMMS Error Codes plus E110, E111, E201, E628


### Request Example

**sendMMS Request**


```xml
<request>
    <action>sendMMS</action>
    <api-key>qTFkykO9JTfahCOqJ0V2Wf5Cg1t8iWlZ</api-key>
    <to>12399471613</to>
    <from>28444</from>
    <operator-id>31062</operator-id>
    <message-subject>The subject</message-subject>
    <service-id>32113</service-id>
    <name>FuelTheFire</name>
    <slide>
        <duration>5</duration>
        <image>
            <url>http://www.yoursite.com/images/1.jpg</url>
        </image>
        <audio>
            <url>http://www.yoursite.com/audio/1.mp3</url>
        </audio>
        <message-text>Here is some text blah blah ...</message-text>
    </slide>
    <slide>
        <message-text>Invitation</message-text>
        <ical><url>http://www.yoursite.com/cal/2.ics</url></ical>
        <duration>10</duration>
    </slide>
</request>
```

### Response examples

**sendMMS Success Response**


```xml
<response>
    <status>Success</status>
    <to>12399471613</to>
    <mms-id>35674</mms-id>
    <tracking-id>MMS_12345</tracking-id>
    <status-details>MMS request accepted and queued for delivery</status-details>
</response>
```

**sendMMS Failure Response**


```xml
<response>
    <status>Failure</status>
    <error-code>E111</error-code>
    <to>12399471613</to>
    <error-info>Invalid shortcode</error-info>
</response>
```

 Contents
- [Introduction](/docs/mms/xml-service/introduction)
- **Send MMS**
- [Save MMS](/docs/mms/xml-service/savemms)
- [Send Saved MMS](/docs/mms/xml-service/sendsavedmms)
- [Delete MMS ID](/docs/mms/xml-service/deletemmsid)
- [Get MMS templates](/docs/mms/xml-service/getmmstemplates)
- [Saved MMS notification](/docs/mms/xml-service/postback-notifications)
- [Appendix](/docs/mms/xml-service/appendix)