Sending and receiving MMS messages

You can send and receive MMS (media messages) in the United States and Canada by using a Twilio phone number that is MMS-enabled. Currently, Twilio offers MMS-enabled long code phone numbers in the US and Canada, as well as MMS-enabled short codes in the US. Read our phone numbers FAQ to learn how to buy an MMS-enabled Twilio long code or to check the capabilities of your existing phone numbers.

MMS is supported for all major mobile carriers in the US and Canada. Media messages sent to carriers where MMS is unsupported will be converted to SMS automatically by default. This includes unsupported carriers in the US and Canada, as well as all non-US/Canada recipients.

Supported media types for MMS

MMS on Twilio offers full support for common image file types: png, jpeg, and gif. In addition, there are other file types which we will accept, but will not make any attempt to modify for device or carrier compatibility. See Accepted Content Types for Media for a full list.

Sending MMS messages (United States and Canada)

At this time, MMS messages can only be sent within the US and Canada. International MMS messaging outside these two countries is not yet supported, however MMS messages sent internationally will be converted to SMS text messages with a URL link to the media.

Sending MMS messages is as easy as sending regular text messages. All you need to do is make an HTTP POST request to the Messages resource URI and specify an image URL in the “MediaUrl” parameter.

You can also specify multiple “MediaUrl” parameters if you wish to include multiple images in one message. Check out our API documentation for code examples.

To reply to incoming messages with an MMS, use the <Message> verb and <Media> noun to send a picture message. Here is an example for how to send a message with text and a picture:

<?xml version="1.0" encoding="UTF‐8"?>
<Response>
    <Message>
        <Body>I drew an owl!</Body>
        <Media>https://demo.twilio.com/owl.png</Media>
    </Message>
</Response>

For more information, please see our Messaging TwiML documentation.

MMS capability can also be added Twilio US short codes. An additional one-time fee is required if you would like to add MMS capability to your new or existing short code. Please see our FAQ on pricing for picture messaging over short codes for more information.

Receiving MMS messages in United States and Canada

If you own an MMS-enabled phone number, your phone number is capable of receiving MMS messages from US and Canada long code phone numbers. Make sure your number is configured to receive messages.

Please note that Twilio phone numbers cannot receive messages from short code numbers.

Sending/Receiving MMS messages in the rest of the world

At this time, MMS is not supported in countries other than the US and Canada.

However, Twilio's MMS Converter feature will automatically convert MMS to SMS when sent to destinations that don't support MMS. These SMS will contain a link in the body to access the media.

You may choose to disable this feature in your Account Settings. If disabled, Twilio will throw a HTTP 400 error when attempting to send an MMS to an unsupported destination.

Have more questions? Submit a request
Powered by Zendesk