What are the supported file types for MMS?

  • text/plain
  • text/vcard
  • image/jpeg
  • image/png
  • image/gif
  • video/3gpp
  • video/mp4

What should the “content-type” of my stored media be, and how does it differ case-by-case?

Content type should equal to one of the above. It can also be application/octet-stream - in that case we try to guess the content type based on the media binary.

Are media files for outbound messages cached within Telnyx? If so, for how long?

Yes, media files for outbound messages are cached within Telnyx for an hour. Changing the media url -- like adding a spurious query parameter -- will invalidate the cache.

How can I secure my media for outbound messages to only be read by Telnyx?

Whitelist 192.76.120.192 and 192.76.120.193.


Does MMS work between countries (ie USA to Brazil)?

No, we don't have this capability yet.

How do MMS DLRs function?

There are three kinds of DLRs. Normally we expect each MMS to generate all of the following:

  1. Internal DLR that is generated when we successfully submit MMS to the aggregator (Syniverse). This DLR changes the status of the stored MDR to “sent”.
  2. MM4_forward.RES - we get this when Syniverse passes our MMS message to the destination carrier. This DLR changes the status of the stored MDR to “delivered”.
  3. MM4_delivery_report.REQ - we (sometimes) get it from the destination carrier and it indicates what happened to the message - usually it means it was delivered to the handset.

How does MMS differ when sending from a Toll-Free Number?

MMS is currently not supported with TF numbers.

How does MMS differ when sending from a Short-Code?

We need a short code provisioned with Vibes and the campaign must be approved by all major carriers.

How can I send a long-text message as a MMS (with no attachments)?

Set the parameter as “type=MMS”.

What is the maximum file size of a single attachment?

Total attachment size must be less than 1 MB. Ideally, it should be 1MB minus 100KB to give some space for encoding overhead.

What about total message size with multiple attachments?

Total message size is capped at 1 MB, and no more than 10 media_urls are allowed.

Did this answer your question?