Rate this page:

Accepted Content Types for Media

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.

Media size limits

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 aware of carrier specific MMS message size limitations for non-images, which we have documented in this article.

Supported MIME types

The following types of content are fully supported by Twilio for Media. This content will be formatted for delivery on destination devices.

  • image/jpeg
  • image/jpg
  • image/gif
  • image/png

Accepted MIME types

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.


  • audio/basic
  • audio/L24
  • audio/mp4
  • audio/mpeg
  • audio/ogg
  • audio/vnd.rn-realaudio
  • audio/vnd.wave
  • audio/3gpp
  • audio/3gpp2
  • audio/ac3
  • audio/webm
  • audio/amr-nb
  • audio/amr


  • video/mpeg
  • video/mp4
  • video/quicktime
  • video/webm
  • video/3gpp
  • video/3gpp2
  • video/3gpp-tt
  • video/H261
  • video/H263
  • video/H263-1998
  • video/H263-2000
  • video/H264


  • image/bmp
  • image/tiff


  • text/vcard
  • text/x-vcard
  • text/csv
  • text/rtf
  • text/richtext
  • text/calendar
  • text/directory


  • application/pdf
  • application/vcard
  • application/

Additional Accepted MIME types by WhatsApp

  • application/msword
  • application/
  • application/
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • audio/aac
  • audio/ogg; codecs=opus
  • image/webp (see below)

The image/webp MIME type is only used for WhatsApp stickers, which have additional requirements. See WhatsApp FAQ for details.

Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

Loading Code Sample...

        Thank you for your feedback!

        Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!