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 media console and Plivo SMS API supports media_urls attachments 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, but these file types are not formatted for destination device compatibility. For a full list of media formats accepted by the Plivo API, please see Accepted Content Types for Media (link below)

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 4 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.

Number of attachments supported

Plivo supports up to a total of 10 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 10 media attachments, as long as the total size of the message body text and all attachments is less than 7 MB.

Connect with to get added to Plivo’s MMS private Beta.