Sending SMS & MMS Messages




* limit: 10 SMS per number per minute
  • The limit for outgoing SMS is 480 characters - sent as multipart message (3 SMS)

  • Each outgoing SMS will count as number of credits.  For USA recipients is 1 credit per 1 SMS, other countries please refer to our international coverage section.

  • IMPORTANT: Please test your campaign well before going live to make sure the correct number of SMS are sent out.


Request parameters:

* required parameters

Parameter Description
MobilePhone  String, valid phone number
Message String
MmsTemplateId Integer, see here »
Subject String
MmsHighResolution Integer, 0 or 1, option to add short URL link in MMS, to view MMS in browser
MmsResend Integer, 0 or 1, if MMS is rejected by carriers, system will resend the message as SMS with short URL to view MMS in browser

Response parameters:

Parameter Description
Id  String
DeliveryReportUrl  String
Message  String

Example Request:

curl -i -H "Accept:application/json" -H "Content-Type:application/json" -XPOST "" -d '{"MobilePhone":"16461234567","Message":"Test Message","ResourceLink":""}'

Example Response Headers:

Status Code: 200 OK
Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0
Connection: Keep-Alive
Content-Type: application/xml; charset=utf-8
Keep-Alive: timeout=5, max=100
Link: <>; 
rel=self Pragma: no-cache Transfer-Encoding: chunked X-Pagination-Current-Page: 1 X-Pagination-Page-Count: 1 X-Pagination-Per-Page: 100 X-Pagination-Total-Count: 1 X-Powered-By: PHP/5.6.2 X-Rate-Limit-Limit: 60 X-Rate-Limit-Remaining: 59 X-Rate-Limit-Reset: 0

Example Response Body:

        "DeliveryReportUrl": "",
"Message":"Text message to 1646xxxxxxx has been sent."
}, ]
<Message>Text message to 1646xxxxxxx has been sent.</Message>
</item> </response>



HTTP Status Codes:

The standard HTTP Status Codes are used. More information is available here:

Error Codes:

Error Codes and Examples here »

Resource File Requirements
File type: jpg, gif, bmp, png, tiff
Recommended audio length: no more than 60 seconds
Keep at a high bitrate
Size: 70.00MB
Animated GIFs are supported up to 7MB