Skip to main content
POST
Send message

Body

application/x-www-form-urlencoded
USERNAME
string
required

Provided account username.

PASSWORD
string
required

Provided account password.

DESTADDR
string
required

Destination MSISDN in international format without a leading +. Example: 255650000001.

SOURCEADDR
string
required

Sender ID. Alphanumeric senders max 11 characters (A-Z, a-z, 0-9, space).

MESSAGE
string
required

Message content. URL-encoded for GSM text; hex-encoded for binary.

CHARCODE
enum<string>

Message encoding. 0 = GSM text (default), 2 = Binary (8-bit).

Available options:
0,
2
DLR
enum<string>

Set to 1 to request a delivery report.

Available options:
0,
1
DLRADDRESS
string<uri>

HTTPS URL to receive delivery reports. Example: https://www.example.com/callback

UDH
string

User Data Header in hex format (e.g. WAP Push).

UDHI
string

Set to non-zero when UDH is present in the message body.

VP
string

Validity period in seconds.

SOURCEADDRTON
string

Type of Number for source: 0 Unknown, 1 International (default), 5 Alphanumeric.

SOURCEADDRNPI
string

Numbering Plan Indicator for source address.

SOURCEPORT
string

Source port (0-65535).

DESTPORT
string

Destination port (0-65535).

CONCATSMSREF
string

Concatenated SMS reference number (0-255).

CONCATSMSSEQ
string

Sequence number for this message part.

CONCATSMSMAX
string

Total number of parts for this message.

Response

Message accepted or rejected. Body contains message ID on line 1, status code on line 2, and optional status text on line 3.

The response is of type string.