Use this endpoint to send an MMS from a Flowroute long code or toll-free phone number to another valid phone number. All Flowroute phone numbers are MMS-enabled. To get started, visit the DIDs page to view all of your Flowroute numbers.
- You will need a Flowroute long code or toll-free phone number in order to send and receive messages.
- Flowroute's maximum MMS message size is 750kB including text. You may have more than one media file attachment so long as they meet the total size limitation of 750kB.
- You are allowed to send one MMS per API request, at a rate of 1 MMS per second.
- Flowroute cannot guarantee delivery to any phone number not enabled for MMS.
- Smart quotes are known to cause errors. Please make sure to use neutral (vertical) quotes in your request.
Valid phone number that you're sending the message to. This number must be in E.164 format. e.g. 12065551234
Flowroute phone number that you're sending the message from. This must be a number that you own in your Flowroute account in E.164 format. e.g. 12065551234
Optional, if media_urls is specified.
The plain-text content of the message that is counted in the total message size which is currently restricted to 750kB. Depending on the length of your message and if you set it to MMS, your message may be broken into multiple fragments and sent as SMS instead. Refer to Message Length & Concatenation for specific information on SMS limitations.
media_urlsarray of strings
Optional, if body is specified. The publicly accessible URL of the media that you are sending. You may attach more than one media file so long as they meet the size limitation of 750kB including text.
A flag that you can set for sending a text-only MMS without specifying a media_urls.
A callback URL that you can configure on a per message basis for delivery receipt updates. Upon sending your MMS, Flowroute will post the delivery receipts to the dlr_callback that you've set. To learn more, see Receive a DLR.
Note: this will override the global mms_dlr_callback if set (see the Set a Callback URL for an Account section for more information.).