Skip to content
Wire2AirWire2Air

Send MMS

Legacy

Send a picture message with the legacy HTTP API (submitmms.aspx). Wire2Air fetches the files from your server.

Last updated

POSTGEThttp://mms.wire2air.com/mms/submitmms.aspx
Credential
User ID, password and VASID, sent as request parameters
Response
Plain text
Transport
Plain HTTP (not encrypted). See the warning on this page.

Send one request per message. The MMS gateway downloads the files named in Attachments from BaseURL, so they must be reachable from the internet when you call it.

Parameters

Parameters
ParameterDescription
VERSION
stringrequired
in body
API version: 1.0.
Example: 1.0
USERID
stringrequired
in body
Your Wire2Air user ID.
PASSWORD
stringrequired
in body
Your Wire2Air password.
VASID
stringrequired
in body
Your VASID.
FROM
stringrequired
in body
The short code Wire2Air assigned to your account.
Example: 27126
TO
stringrequired
in body
Destination mobile number with country code, for example 17321234567 (US) or 919810601000 (India).
Example: 17321234567
Subject
stringrequired
in body
The MMS subject.
BaseURL
stringrequired
in body
The address where all the message's files can be found. Required unless you send MMSCode instead.
Example: https://example.com/mms/
Attachments
stringrequired
in body
Comma-separated names of the files to include, fetched from BaseURL. Required unless you send MMSCode instead.
Example: logo.gif,offer.jpg
MMSCode
stringoptional
in body
Instead of BaseURL and Attachments: the code of a message in your Wire2Air MMS repository, or of an MMS you sent before (returned as MMSCODE).
DeliveryDateTime
stringoptional
in body
When to deliver, in UTC, as MM/DD/YYYY HH:MM:SS. See scheduling.
Default: now

Examples

curl "http://mms.wire2air.com/mms/submitmms.aspx" \
  --data-urlencode "VERSION=1.0" \
  --data-urlencode "USERID=YOUR_USERID" \
  --data-urlencode "PASSWORD=YOUR_PASSWORD" \
  --data-urlencode "VASID=YOUR_VASID" \
  --data-urlencode "FROM=27126" \
  --data-urlencode "TO=12121234567" \
  --data-urlencode "Subject=Demo message" \
  --data-urlencode "BaseURL=https://example.com/mms/" \
  --data-urlencode "Attachments=logo.gif,offer.jpg"

Response

Success
JOBID: [MOBILENUMBER]:[MMSID]:[MMSCODE]

Keep MMSCODE: you can send the same content again by passing it as MMSCode.

ErrorMeaning
ERR:301: Failed authenticationAuthentication failed.
ERR:302: Invalid vasidThe VASID is wrong.
ERR:303: Invalid passwordThe password is wrong.
ERR:304: Invalid logonThe login is not valid.
ERR:305: Not enough creditsTop up your account.
ERR:306:Message Receipient is missingTO is missing.
ERR:307: Invalid delivery date time.DeliveryDateTime could not be read.
ERR:312: Failed to download content object.A file could not be fetched from BaseURL.
ERR:313: Invalid MMS CodeThe MMSCode is unknown.
ERR:314: Invalid MMS Code or no files specified.Neither a valid MMSCode nor any files.
ERR:400: System errorServer-side error; contact support.