SMS

Send an MMS

Send a single MMS to a single number. Subject, message and attachments combined must be non-empty and at most 300,000 bytes. Attachments are hashes of images already uploaded through the account's MMS attachment upload flow. Unlike /sms/, validity is in hours (default 24) and the failure key in the response is an object, not an array

get/mms/

Request

  • Base URL: http://api.smsfusion.com.au
  • URL: http://api.smsfusion.com.au/mms/
  • Auth: one of:
    • API key in query parameter key
    • HTTP basic

Query parameters

keystring required

API Key as generated from the <a href='https://www.smsfusion.com.au/admin/api/'>admin panel</a>

numstring required

Destination number - exactly one; multiple numbers are rejected with 401 OVER_LIMIT

msgstring

Message text

subjectstring

MMS subject

attachment0string

Hash of an uploaded image; attachment0 through attachment13 are accepted (up to 14)

fromstring

A single phone number or <a href='https://www.smsfusion.com.au/help/msisdn/'>MSDISDN</a>

ccstring string

2 character country code <a href='https://en.wikipedia.org/wiki/ISO_3166-2'>ISO 3166-2</a> for formatting local numbers internationally

deliverbystring

UTC encoded time to send the SMS

dlrcbstring

HTTP or HTTPS <a href='https://www.smsfusion.com.au/help/dlr-callback/'>callback URL for delivery reports</a>. Timeout for callbacks is set to 30 seconds

replycbstring

HTTP or HTTPS <a href='https://www.smsfusion.com.au/help/reply-callback/'>callback URL for replies</a>. Timeout for callbacks is set to 30 seconds

replyemailstring

Email address to send replies to

validityinteger

Validity period in HOURS (default 24) - note /sms/ uses minutes

messageposinteger

1 = message text before attachments

Response

Queued. {id, success, cost, count}; on partial failure adds failure as an OBJECT keyed by stringified index

Changes

No recorded changes to this operation across all 1 revision of this API.