Send SMS to one or more destinations from a single source

Sends a single message to one or more destination numbers using one sender ID.
Multiple destinations can be submitted in a single call by separating numbers with a comma.

Authentication is performed using username and password passed as query parameters —
there is no separate header-based authentication for this API.

Response codes

CodeMeaning
1701Message submitted successfully. Response format: 1701|<destination>|<message_id>
1702One of the required parameters was not provided or left blank
1703Invalid username or password
1704Invalid value in type field
1705Invalid message content
1706Invalid destination number
1707Invalid source (sender) value
1708Invalid value for dlr field
1709User validation failed. This is the only code where a retry may help
1710Internal error
1025Insufficient credit on the account
1026Insufficient reseller credit
1715Response timeout — do not resubmit the same message

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

When multiple destinations are submitted, the batch stops immediately if any error
other than an invalid destination occurs. An invalid destination is simply skipped,
and the rest of the batch continues.

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

Username of the HTTP account

password
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

0: delivery report not required, 1: delivery report required

Allowed:
string
required

Destination mobile number(s). Multiple numbers are separated by a comma (comma must be URL-encoded). The leading '+' is optional and must be URL-encoded if included.

string
required
length ≤ 18

Sender ID shown on the message. Max length 18 if fully numeric, max length 11 if alphanumeric.

string
required

Message content, URL-encoded. For type 2 or 6 (Unicode/Unicode Flash), the message must be encoded in UTF-16BE hex format.

string

Destination link for WAP Push messages (type=4 only). Not required for any other message type; if supplied for other types it is ignored.

Responses

400

Malformed request — a required query parameter is missing

401

Authentication failed — invalid username or password

500

Internal server error while processing the request

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