Schedule an SMS for future delivery

get

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

Schedules a message to be sent at a specified future date and time, in a specified GMT offset, instead of sending immediately. Supports the same message types as the standard messaging endpoint. On success, the platform returns a job ID that identifies the scheduled batch.

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

https://sms-eu.rmlconnect.net:8443/bulksms/schedulemsg?username=your_username&password=your_password&message=test&type=0&dlr=1&source=123456&destination=91XXXXXXXXXX&scheduledate=08/01/2025&scheduletime=12:45%20pm&gmt=GMT%20%2B5:30

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.

message

string

required

Message content to be sent, URL/UTF-8 encoded.

destination

string

required

Destination number(s). More than one destination is comma-separated.

type

integer

enum

required

Message type. 0 = Text, 1 = Flash, 2 = Unicode, 4 = WAP, 6 = Unicode-Flash.

Allowed:

source

string

required

Sender ID shown on the recipient's device.

scheduledate

string

required

Date the message should be sent, in MM/dd/yyyy format (e.g. 08/01/2025 for August 1, 2025).

scheduletime

string

required

Time the message should be sent, in hh:mm am/pm format (URL-encoded), where hh runs from 00 to 12 and mm is 00–59 — e.g. 12:45 pm.

gmt

string

required

Timezone offset to apply to the scheduled date/time (URL-encoded). Accepted formats: GMT +hh:mm, GMT -hh:mm, +hh:mm, or -hh:mm — e.g. GMT +5:30.

dlr

integer

enum

required

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

Allowed:

url

string

URL to include for WAP messages (type=4). Can be left empty for other message types. (Optional)

Responses

Code	Status	Meaning
1701	Success	Message has been scheduled successfully. Response includes the job ID.
1702	Failed	One of the required parameters is missing.
1703	Failed	User authentication failed.
1704	Failed	Given message type is invalid.
1705	Failed	Given message is invalid.
1706	Failed	Given destination is invalid.
1707	Failed	Given sender/source is invalid.
1710	Failed	Unknown error.
1712	Failed	Bad database connection.
1713	Failed	Too many destinations in a single request.
1902	Failed	Given date is invalid.
1903	Failed	Given GMT offset is invalid.
1904	Failed	Given time is invalid.
1905	Failed	Given date and time combination is invalid.

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