Send an SMS message

get

https://sms-eu.rmlconnect.net:8443/bulksms/bulksms

Sends a single SMS message (plain text, flash, Unicode, or WAP push) to one or more destination numbers. This is the standard message-submission endpoint for the platform. Multiple destinations can be submitted in a single call by separating numbers with a URL-encoded comma. All parameter values — especially message and any URLs — should be URL/UTF-8 encoded.

Sample request URL (replace credentials, source, destination, and message with your own before use):

https://sms-eu.rmlconnect.net:8443/bulksms/bulksms?username=your_username&password=your_password&type=0&dlr=1&destination=91XXXXXXXXXX&source=ralert&message=Demo%20Message

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

username

string

required

Account username for the HTTP account.

password

string

required

Account password for the HTTP account.

type

integer

enum

required

Message encoding/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). Value 3 is reserved and not used.

Allowed:

dlr

integer

enum

required

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

Allowed:

destination

string

required

Destination mobile number(s). An optional leading plus (+) sign may be included (URL-encoded). Multiple numbers are separated by a URL-encoded comma.

source

string

required

length ≤ 18

Sender ID shown on the recipient's device. Max 18 characters if numeric, max 11 if alphanumeric. Prefix a URL-encoded plus (+) sign if you want it displayed on the recipient's phone.

message

string

required

Message content, URL/UTF-8 encoded. Supports long (concatenated) messages — every 153 characters count as one part for plain text, and every 268 characters for Unicode. For WAP Push (type=4), this is the display text.

tagname

string

Optional identifier/campaign tag for internal reference. (Optional)

Responses

Code	Status	Meaning
1701	Success	Message submitted successfully. Use the returned message ID to map delivery reports later.
1702	Failed	Invalid URL — a required parameter was missing or left blank.
1703	Failed	Invalid username or password.
1704	Failed	Invalid value in the `type` field.
1705	Failed	Invalid message content.
1706	Failed	Invalid destination.
1707	Failed	Invalid source/sender.
1709	Failed	User validation failed. Safe to retry.
1710	Failed	Internal error.
1025	Failed	Insufficient credit.
1715	Failed	Response timeout — do not resubmit the same message.
1032	Failed	Message rejected — destination is on DND.
1028	Failed	Message flagged as spam.
1041	Failed	Duplicate message.
1042	Failed	Explicit DND destination.
1033	Failed	Sender/template mismatch.
69	Failed	Internal error.
8	Failed	Internal error.
16	Failed	IP blacklisted.
18	Failed	User IP not whitelisted.

400

Malformed request — one or more required query parameters missing or invalid.

401

Authentication failed at the transport/gateway level.

500

Unexpected server error.

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

text/plain