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.
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.
Notice: MMS can only be sent to/from US Short Code numbers if the mobile user is on a major US network (AT&T/Sprint/T-Mobile/Verizon). MMS from/to providers such as Google Voice and any others not listed above will fail.
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.
Sending MMS messages in the rest of the world
Outbound MMS from Twilio is only supported from US and Canada-based phone numbers. Outbound MMS messages are supported to all major mobile carriers in these destinations.
MMS message requests terminating to unsupported MMS carriers in the US and Canada, or non-US/Canada destinations, can be converted to SMS messages with a short URL link to the media by enabling MMS Converter. Without using MMS Converter, these message requests will receive an
HTTP 400 response from the Twilio REST API.
For more information, please see Getting Started with MMS Converter.
Receiving MMS messages
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.