send-mms

name	send-mms
description	Send MMS (multimedia) messages via the Kudosity platform. Use when the user wants to send a message with images, GIFs, videos, or audio to a recipient.

Send MMS Messages

MMS messages are sent via the Kudosity V2 API and support images, GIFs, videos, and audio attachments.

Authentication

• Header: x-api-key: {KUDOSITY_API_KEY}
• If the user hasn't configured credentials, direct them to run /kudosity-sms:setup

API Details

• Endpoint: POST https://api.transmitmessage.com/v2/mms
• Content-Type: application/json
• All requests use curl commands

Parameters

Required:

• sender (string): The sender number (must be assigned to the account)
• recipient (string): Destination number (local or E.164 international format)
• content_urls (array of strings): URLs to the media files to attach

Optional:

• subject (string): Message subject — max 20 characters, ASCII only
• message (string): Body text — max 1,000 characters. Use [opt-out-link] for opt-out if required
• message_ref (string, max 500 chars): Your reference ID, returned in webhooks
• track_links (boolean): Enable link tracking with shortened URLs

Example curl Command

curl -s -X POST "https://api.transmitmessage.com/v2/mms" \
  -H "x-api-key: ${KUDOSITY_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "New Arrival",
    "message": "Check out our latest product!",
    "sender": "61481074185",
    "recipient": "61435795809",
    "content_urls": ["https://example.com/product.jpg"]
  }'

Supported Media

Format	Type	Media Type	Limit
JPEG, JPG	Image	image/jpeg	Up to 400 KB
GIF (incl. animated)	Image	image/gif	Up to 400 KB
PNG	Image	image/png	Up to 400 KB
BMP	Image	image/bmp	Up to 400 KB
MP3	Audio	audio/mpeg	Up to 400 KB
WAV	Audio	audio/wav	Up to 400 KB
MPEG, MPG, MP4	Video	video/mpeg4	Up to 400 KB

Recommended Image Dimensions

For best visibility on mobile devices, use one of these recommended sizes:

• 480px × 480px
• 640px × 640px

Note: Some older handset models have limited support for certain image formats, so results may vary.

Important Notes

• Only one media file can be attached at a time, up to 400 KB
• Media URLs must be absolute paths (e.g., https://example.com/image.jpg), not relative paths
• Currently MMS can only be sent to Australia
• The subject field is limited to 20 characters and ASCII characters only
• Always ask the user which sender number to use if not specified
• The sender must be a number assigned to their account