To send a media message, you must include the
MediaUrl parameter when making a request to the Twilio Programmable SMS API. Twilio checks the
content-type header at the provided
MediaUrl to validate the content type of the media file. If the
content-type header does not match that of the media file, Twilio will reject the request.
When you send an outbound message, the total message size must be under the maximum size limit for the channel. An API request with media or a collection of media larger than the size limit will fail with an error.
For a media message, the maximum size limit is 5MB.
Please be mindful of carrier specific MMS message size limitations for non-images, which we have documented in this article.
The following types of content are fully supported by Twilio for Media. This content will be formatted for delivery on destination devices.
The following types of content are accepted by the Twilio API for Media. Requests will not be rejected, but content will not be modified for device compatibility.