Skip to main content
POST
Send message (XML response)

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

XML response with per-recipient results and balance.

The response is of type string.