Using the SMS REST API

Overview

SMS messages are sent by making HTTP or HTTPS calls to the API. You can loop through your list of mobile numbers and make HTTP/S requests to send SMS messages to them. Generally, this API should allow you to submit up to about 100 messages per second to our platform on average (or faster if required).

It’s quick to get started and there is no need to understand the additional or advanced features unless you want to use them.

Why use this API? 

• Supports JSON and XML data formats.
• Supports HTTP (port 80) and HTTPS (port 443).
• You can send to multiple handsets in one single HTTP/S request (up to 200) – this is useful if you are sending the same message text to all handsets.
• Supports persistent connections (keep-alive) and the use of multiple concurrent connections.
• Various HTTP status codes are used. Click here to view the list.

Send your first message

• Step 1: Replace the example authentication token below with your token. 
• Step 2: Replace the example mobile numbers below with your number, using the correct international format. This means:
  • The mobile number needs to start with the correct country code.
  • There must be no spaces or other non-numeric characters.
  • If the mobile number starts with zero, remove the zero before typing the rest of the number.
• Step 3: Type your message text. Please note that until you make a purchase, your messages will contain pre-defined content.

HTTP headers explained

Security

For added security, you can opt to:

• Use HTTPS for all API requests.
• Enable IP lockdown on your API connection.

Authenticating

All authentication is done using an authentication token (generated within Developers’ Central account). This token needs to be passed onto every REST API call. The header used for this is explained in the section called ‘HTTP Headers Explained’.