Send an MMS Message
Learn more about sending an MMS with Mobile Text Alerts
MMS stands for Multimedia Messaging Service used for sending messages that include a media attachment. MMS messages have a 500 KB size limit, a 1550 character limit, and a higher credit cost per send than SMS.

Credit Costs
1 credit cost per SMS message (160 character limit, no attachment)
3 credit cost per MMS message (1550 character limit, plus 500KB image attachment)
When to use MMS over SMS
Some situations where MMS is worth using instead of SMS:
Very long text content
Sales-oriented content, where an image would can help drive the call-to-action
Audience is primarily within the US/Canada
A Mobile Text Alerts plan with rollover and/or excess credits
Target audience responds better to media in messages
Supported attachment types
The following file types are supported to use as attachments for MMS:
Attachment hosting with rehost
field
rehost
fieldYou can choose to host the URL of an attachment for an MMS on your own servers, or it can be hosted by MTA. When sending a request to the /send
endpoint, if the rehost
flag is set to true
, the attachment will be rehosted by MTA before sending. This can be useful if the recipient isn't receiving your attachment or you don't want to host the attachment.
How to send an MMS with the API
MMS are sent via the API with a POST
request to the /send
endpoint just like SMS, but include the image
field for the URL of the attachment that will be sent. All requests to this endpoint must contain both recipient and content information.
Required request fields:
Choose recipient(s): (Must be one of the following)
subscriberIds: number[]
- List of subscriber IDs of recipients. Messages can be sent to specific subscribers, with each subscriber assigned a uniquesubscriberId
.subscribers: (number | string)[]
- List of recipient phone numbers or email addresses. A new subscriber will be created for new recipients that are not already subscribers on your account.allSubscribers: boolean
- Flag to indicate send message to all subscribers iftrue
. WhenallSubscribers
is set totrue
, no other recipient fields should be specified. Default value isfalse
.groups: number[]
- List of group IDs of recipients. Messages can be sent to specific groups, with each group assigned a uniquegroupId
.threadId: number
- Messages can be sent in reply to a thread, with each thread assigned a uniquethreadId
.
Content: (Must include at least one of the following)
message: string
- The content of the message being sent.image: string
- The URL of an attachment for a message. By default, messages with attachments (image
) will be sent as an MMS. This URL needs to be publicly accessible; this ensures Mobile Text Alerts can access it when sending.templateId: number
- Messages can be saved as pre-set message templates for reuse with saved controlled templates on your account assigned atemplateId
. Visit Message Templates tutorial to learn more.
Other fields:
rehost: boolean
- If therehost
flag is included and is set totrue
, the attachment will be rehosted by MTA before being sent to the recipients.
How to send an MMS with the API
Form API request
Create the API request to the /send
endpoint. Remember to include Authorization header.
curl --location 'https://api.mobile-text-alerts.com/v3/send' \
--header 'Authorization: Bearer 89fa747a-e01b-5940-99c2-4e96fa996258' \
--data '{"subscribers": [1112223333],
"message": "Use promo code TESTMESSAGE for 5% off when you sign up. STOP to end",
"image": "https://imgur.com/gallery/example"
}'
Learn More
Last updated
Was this helpful?