Schedule SMS

Schedules a bulk SMS message for delivery at a future date and time, in a specified timezone. Useful for campaigns or notifications that need to go out at a fixed time rather than immediately.

Response Codes

| Code | Meaning | |------|---------| | 1701|JobId | Message scheduled successfully | | 1702 | One of the parameters is missing | | 1703 | User authentication failed | | 1704 | Given type is invalid | | 1705 | Given message is invalid | | 1706 | Given destination is invalid | | 1707 | Given sender is invalid | | 1710 | Unknown error | | 1712 | Bad DB connection | | 1713 | Too many destinations | | 1902 | Given date is invalid | | 1903 | Given gmt value is invalid | | 1904 | Given time is invalid | | 1905 | Given date and time combination is invalid |

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

Account username.

string
required

Account password.

string
required

Message content to be sent at the scheduled time.

integer
enum
required

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

Allowed:
integer
enum
required

Set to 1 to request a delivery report, 0 to skip it.

Allowed:
string
required

Sender ID assigned to the account.

string
required

Destination mobile number(s) with country code. Multiple numbers can be comma-separated.

string
required

Scheduled delivery date, in MM/dd/yyyy format (e.g. 04/04/2023).

string
required

Scheduled delivery time, in hh:mm am/pm format (e.g. 07:45 pm). Must be URL-encoded (space becomes %20).

string
required

Timezone offset for the scheduled date and time, e.g. "GMT +5:30" or "-10:00". Must be URL-encoded.

string

Used only for type 4 (WAP) messages. Can be left empty for all other message types.

Responses

400

Bad request — one or more parameters are missing or invalid.

401

Unauthorized — invalid username or password.

500

Internal server error.

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