What file types does the Plivo MMS API support for MMS media messages?

Plivo SMS API supports sending picture messages (AKA MMS or multimedia messages) by adding the media_urls  or media_id  parameter to your API request and setting the type parameter as MMS. 

Supported file types

Plivo’s media console and Plivo’s SMS API supports media_urls attachment with the following image file formats:

  • jpeg
  • png
  • gif

These image file types are fully supported by Plivo on destination devices. Plivo accepts a number of additional file formats as media_urls attachments. However, these file types are not formatted for destination device compatibility. For a full list of media formats accepted by the Plivo API, please refer to the accepted content types for media list here

File size limitations (for non-image files)

For multimedia attachments, the file size limit for media_urls attachments depends on the receiving carrier. Here are the attachment size limitations for the top four US-based carriers:


MMS attachment size


1.4 MB


1.4 MB


0.675 MB


0.675 MB

For other MMS-supported carriers, we recommend using attachments no larger than 600KB when sending files that are not jpeg, png, or gif images.

How many attachments does Plivo support?

Plivo supports up to a total of ten attachments (with a combination of media_urls  and media_ids  ) with a maximum of 2MB per attachment, as long as the total size of the message body text and all attachments are less than 5 MB. An MMS message body can be up to 1600 characters long, which equals 4.8KB or roughly 1% of the total size limit.

If your message (including body text and media) is larger than 5 MB, your message request will fail.

Incoming MMS messages

Plivo supports up to ten incoming media attachments, as long as the total size of the message body text and all attachments is less than 7 MB.

Was this article helpful?
0 out of 0 found this helpful
Didn’t find what you are looking for? Create new ticket