Send SMS message(s)

Sends a text, flash, unicode, or WAP push message to one or more destination numbers. Multiple destinations can be specified as a comma-separated list. Delivery reports can be requested using the dlr parameter.

Response Codes

| Code | Description | |------|-------------| | 1701 | Success. Format: 1701\|<destination>\|<message_id> — use the message ID to map delivery reports to this message. | | 1702 | Invalid URL — one of the parameters was not provided or left blank. | | 1703 | Invalid value in username or password field. | | 1704 | Invalid value in type field. | | 1705 | Invalid message. | | 1706 | Invalid destination. | | 1707 | Invalid source (sender). | | 1709 | User validation failed. Safe to retry. | | 1710 | Internal error. | | 1025 | Insufficient credit. | | 1715 | Response timeout — do not resubmit the same message. | | 1032 | DND reject. | | 1028 | Spam message. | | 1041 | Duplicate message. | | 1042 | Explicit DND destination. | | 1033 | Message template mismatch. | | 16 | IP blacklisted. | | 18 | Non-whitelisted user IP. |

Standard SMPP v3.4 error codes may also be returned where applicable. Apart from error code 1709, messages should not be resubmitted for any other error code.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

Username of the HTTP account.

string
required

Password of the HTTP account.

integer
enum
required

Message type: 0 - Plain text (GSM 03.38), 1 - Flash (GSM 03.38), 2 - Unicode, 4 - WAP Push, 5 - Plain text (ISO-8859-1), 6 - Unicode Flash, 7 - Flash (ISO-8859-1).

Allowed:
integer
enum
required

Whether a delivery report is required. 1 = required, 0 = not required.

Allowed:
string
required

Mobile number(s) the message is sent to. Multiple numbers are comma-separated (comma must be URL encoded). May optionally include a leading + (URL encoded).

string
required

Sender address shown on the message. Max 18 characters if numeric, max 11 if alphanumeric.

string
required

Message content, URL-UTF-8 encoded. For WAP Push (type=4), this is the display text. Long messages are supported and split per SMS segment limits.

string

Landing page URL, required only when type=4 (WAP Push).

string

Optional additional identifier for the client's own reference.

Responses

400

Bad request — malformed query string or missing required parameter.

401

Unauthorized — invalid username or password.

500

Internal server error.

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/plain