Sending and receiving MMS messages
You will be able to send and receive MMS as long as your Twilio phone number is MMS-enabled. Currently Twilio offers MMS-enabled long code phone numbers in the US and Canada as well as MMS-enabled Twilio short codes in the US. Read our phone numbers FAQ to learn how to buy an MMS-enabled Twilio long code or check the capabilities of your existing phone numbers.
Sending MMS messages in United States and Canada
At this time, MMS messaging can only be sent within 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. MMS messages sent in the US or Canada to unsupported carriers will also be sent via SMS.
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 your 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 shortcodes for more information.
Receiving MMS messages in United States and Canada
If you own an MMS-enabled phone number, your phone number is already ready to receive MMS messages from other 10-digit long code phone numbers. Twilio phone numbers cannot receive messages from shortcodes.
Sending/Receiving MMS messages in the rest of the world
At this time sending/receiving MMS messages between Twilio US and Canadian phone numbers and other countries is not supported. These MMS messages will be converted to SMS text messages with a shortened URL linking to your media. The URL (http://m.twil.io followed by 7 characters) will be appended to the body of your SMS text message.
You may choose to disable this feature in your “MMS Converter” section of your Messaging Settings. If disabled, Twilio will throw a HTTP 400 error when attempting to send an international MMS.