MMS Transcoding

Destination carriers impose various restrictions on MMS message sizes (see below), and these restrictions are contingent on both the destination carrier and the type of phone number. To assist our users in complying with these restrictions, we provide a messaging profile setting known as mms_transcoding. When this setting is enabled (set to true), we will adjust the size of the media to adhere to the size requirements of the destination. However, please take note of the following:

• Only images and videos will undergo resizing. Additionally, please be aware that animated GIFs are not supported. If you intend to send animated GIFs, ensure that they are small enough.
• It's important to understand that resizing will typically result in a reduction in the quality of the media.
• During the resizing process, images will be converted to JPEG format, while videos will be converted to H.264 MP4.

curl -i -X PATCH \
  'https://api.telnyx.com/v2/messaging_profiles/<YOUR_MESSAGING_PROFILE_ID>' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
	"mms_transcoding": true
  }'

The table below shows the MMS message limits imposed by the destination carriers.

Destination Carrier	Source Number Type	Maximum Size
AT&T	Long code	1 MB
AT&T	Toll free	600 KB
AT&T	Short code	600 KB
Sprint	Long code	1.5 MB
Sprint	Toll free	600 KB
Sprint	Short code	1 MB
T-Mobile	Long code	1.5 MB
T-Mobile	Toll free	600 KB
T-Mobile	Short code	1 MB
Verizon	Long code	1 MB
Verizon	Toll free	600 KB
Verizon	Short code	1.2 MB