Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Accepted Content Types for Media

When specifying one or more MediaUrls when sending a message, content types for MediaUrl validation are fetched via the content-type header at the provided URLs. If the content-type header does not match the media, Twilio will reject the request.

Total message size must be under 5MB. An API request with media or collection of media larger than 5MB will fail with an error.

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/gif
  • image/png

The Twilio API for WhatsApp supports sending and receiving images, audio, PDF files, and video. The following formats are currently supported:

  • Images: JPG, JPEG, PNG
  • Audio: MP3, OGG, AMR
  • Documents: PDF
  • Video: MP4

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/vorbis
  • audio/vnd.rn-realaudio
  • audio/vnd.wave
  • audio/3gpp
  • audio/3gpp2
  • audio/ac3
  • audio/vnd.wave
  • 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/jpeg
  • image/gif
  • image/png
  • image/bmp


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


  • application/pdf
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 browsing the Twilio tag on Stack Overflow.