Skip to main content
POST
/
transactional_messages
/
send_mms
Send an MMS Message
curl --request POST \
  --url https://api.v3.tatango.com/transactional_messages/send_mms \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "phoneNumber": "5551234567",
  "webhookUrl": "https://yourpostbackaddress.com",
  "content": "Check out this amazing image!",
  "subject": "Amazing Image",
  "attachmentUrl": "https://tatango-mms-attachments-production.s3.us-west-2.amazonaws.com/example-image.jpg",
  "smsFailover": "See our amazing image at example.com"
}
'
{
  "message": "Request accepted, sending message to recipient",
  "transactionId": "019687e1-1b54-70f4-a68a-60af7fa776f4"
}

Documentation Index

Fetch the complete documentation index at: https://platform.tatango.com/llms.txt

Use this file to discover all available pages before exploring further.

You can use any publicly accessible URL for attachments, or upload them to Tatango using the attachments page.File Size Limits:
  • Shortcodes: Images (1MB), GIFs (0.6MB), Videos (2MB)
  • 10DLC: All files (0.75MB)
Supported File Types: JPG, JPEG, PNG, GIF, WebP, MP4, MPEG, vCard

Authorizations

​
x-api-key
string
header
required

Your Tatango API key. This is required for all requests to the API. You can find your API key in the Tatango App under My Account -> API -> Create API Key.

Body

application/json

MMS message request

​
phoneNumber
string
required

The destination phone number. Can be provided in any format (e.g., +1 555-123-4567, (555) 123-4567, 5551234567) but must be a valid U.S. or Canadian phone number.

​
webhookUrl
string
required

URL where webhooks will be sent. Must be a valid HTTPS URL.

Maximum string length: 255
​
content
string
required

The MMS message content.

Maximum string length: 3500
​
smsFailover
string
required

SMS fallback message content used when primary delivery method fails. Must contain only GSM 7-bit characters.

Required string length: 1 - 160
​
subject
string

Optional subject line for the MMS message.

Maximum string length: 40
​
attachmentUrl
string

Optional URL of an attachment, hosted by Tatango or an external website.

Maximum string length: 255

Response

MMS message accepted

​
message
string
required

Success message indicating the request was accepted.

​
transactionId
string
required

Unique transaction identifier for tracking the message.