The Plivo SMS API supports sending picture messages (a.k.a. MMS or multimedia messages) by adding a media_urls or media_id parameter to your API request and setting the type parameter to MMS.
Supported file types
Plivo supports media_urls attachments with the following image file formats:
- JPEG
- PNG
- GIF
Plivo accepts several additional file formats as media_urls attachments but does not format them for destination device compatibility. See our documentation for a full list of supported media formats.
File size limitations
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:
|
Carrier |
Long Code |
Toll-Free |
Short Code |
|
Operators |
MMS attachment size |
MMS attachment size |
MMS attachment size |
|
AT&T |
0.675MB |
0.750MB |
0.600MB |
|
Sprint |
1.400MB |
0.750MB |
1.400MB |
|
T-Mobile |
1.500MB |
0.750MB |
1.000MB |
|
Verizon |
0.675MB |
0.750MB |
1.200MB |
For other 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 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 is less than 5MB. An MMS message body can be up to 1,600 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 5MB, your message request will fail with Plivo error code 120.
If you have more than 10 attachments, Plivo will fail your message request with an HTTP status code of 400.
|
{ |
If your MMS exceeds the file size limit, Plivo will fail the message with a Plivo error code of 120.
Incoming MMS messages
Plivo supports up to 10 incoming media attachments, as long as the total size of the message body text and all attachments is less than 7MB. If the total size exceeds this limit, Plivo will not process the message.