Send an SMS message

Submits a single message or a batch of messages (comma-separated destinations) for delivery. Supports plain text, flash, Unicode, Unicode flash, and WAP Push message types. The response is returned as a plain-text, pipe-delimited string rather than JSON — see the response schema below for the exact format.

Response code reference

| Code | Meaning | |------|---------| | 1701 | Success — message submitted. Response format: 1701\|<destination>\|<message_id> | | 1702 | Invalid URL error — a required parameter was missing 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) | | 1708 | Invalid value for dlr field | | 1709 | User validation failed — this is the only code where a retry is recommended | | 1710 | Internal error | | 1025 | Insufficient credit — batch is aborted at the destination where this occurs | | 1715 | Response timeout — do not resubmit the same message |
Standard SMPP v3.4 error codes may also be returned where applicable, alongside the codes above. For any code other than 1709, resubmitting the same message is not recommended.

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

HTTP account username used for authentication.

string
required

HTTP account password used for authentication.

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). Unicode message content (types 2 and 6) must be submitted as UTF-16BE hex.

string
required

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

string
required
length ≤ 18

Sender ID shown on the recipient's handset. Max 18 characters if numeric, max 11 if alphanumeric. Prefix with URL-encoded '+' if a leading plus should be displayed. The SMSC may enforce additional restrictions on this field.

string
required

Message content, URL-encoded (UTF-8). For type 2/6 (Unicode), content must be UTF-16BE encoded as hex. Supports long/concatenated messages — counted as one segment per 153 characters (plain text) or 268 characters (Unicode). For WAP Push (type=4), this is the text displayed in the message.

integer
enum
required

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

Allowed:
string

WAP Push link (only used when type=4). URL-encoded (UTF-8). Ignored and not required for any other message type.

Responses

400

Malformed request — one or more required query parameters missing or invalid at the transport level.

401

Authentication failed at the transport/gateway level (distinct from the 1703 platform-level code).

500

Internal server error at the transport/gateway level (distinct from the 1710 platform-level code).

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