Send a bulk SMS message

Submits an SMS message (plain text, flash, Unicode, or WAP Push) to one or more destination numbers. Multiple destinations can be submitted in a single request as a comma-separated list. The response is returned as plain text, with one result line per destination.

Response codes

| Code | Meaning | |------|---------| | 1701 | Success — message submitted. Response format: 1701\|<CELL_NO>\|<MESSAGE_ID>. Use the message ID to map delivery reports later. | | 1702 | Invalid URL — one or more required parameters was missing or left blank. | | 1703 | Invalid value in username or password. | | 1704 | Invalid value in type. | | 1705 | Invalid message. | | 1706 | Invalid destination. | | 1707 | Invalid source (sender). | | 1708 | Invalid value in dlr. | | 1709 | User validation failed. Safe to retry. | | 1710 | Internal error. | | 1025 | Insufficient credit. Batch is aborted at the destination where credit ran out. | | 1715 | Response timeout. Do not resubmit the same message. | | 1032 | Rejected — destination is DND registered. | | 1028 | Rejected as spam. |
Standard SMPP v3.4 error codes may also be returned where applicable. Apart from code 1709, none of the above codes should be treated as retryable.

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

HTTP account username.

string
required

HTTP account password.

integer
enum
required

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

integer
enum
required

0 = delivery report not required, 1 = delivery report required.

Allowed:
string
required

Destination mobile number(s), with or without a leading +. Multiple numbers can be comma-separated (comma must be URL-encoded).

string
required

Sender ID shown on the message. Max 18 characters if numeric, max 11 characters if alphanumeric. Prefix + (URL-encoded) if you want it to display on the handset; the SMSC may enforce further restrictions.

string
required

Message content, URL-encoded (UTF-8). For type=2 or type=6 (Unicode), the message must be hex-encoded UTF-16BE. Long messages are automatically concatenated: 153 characters per segment for plain text/flash, 268 characters per segment for Unicode.

string

Only used when type=4 (WAP Push) — holds the link to be sent, URL-encoded (UTF-8). Ignored for all other message types.

Responses

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