Plivo  SMS API supports sending picture messages (AKA MMS or multimedia messages) by adding the Media_Urls parameter to your API request and setting the type parameter as MMS. Continue reading for more details on the supported file types, and attachment file size limitations.


Supported File Types

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:


Carrier

MMS attachment size

AT&T

1.4 MB

Sprint

1.4 MB

T-mobile

0.675 MB

Verizon

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 10 MediaUrl attachments, as long as the total size of the message body text and all attachments is 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 MediaUrl attachments, as long as the total size of the message body text and all attachments is less than 7 MB.

Connect with support@plivo.com to get added to Plivo’s MMS private Beta.