API Basics
Keep these basics in mind and you’ll be set up for success with our APIs.
The Basics
Access
Before starting, make sure your user profile is set to API access. You can make this change in the Customer Portal under User Management. Learn more here: API Authentication
Authentication
All API calls require an authentication token. Learn more here: API Authentication
Content Type
All API POST requests require the content-type header set to application/json.
Protocol
All API requests must be made with HTTPS.
The Formats
Long Code Format
- Supply a long code (or telephone number) in E.164 format.
- In the URL, the “+” of the E.164 format should be url-encoded as “%2B”.
Short Code and Alphanumeric Sender ID Format and Examples
- Supply a short code or alphanumeric sender ID in the following format: {countrycode}-{code}
- countrycode is the country code from where the shortcode or alphanumeric sender ID resides
- code is the actual code
- A USA short code (88888) would be 1-88888
- A Colombia shortcode (12345) would be 57-12345
- A Spain Alphanumeric Sender ID (Hello8) would be 34-Hello8
Security
Legacy TLS version 1.1 and SSLv3 are not supported.