Quick Start Guide

Get up and running with our Quick Start Guide and start developing your integration.

Integrating with us can begin as soon as you create an account, and this requires three steps:

  1. Generate your API key so we can authenticate your integration’s API requests.
  2. Start building so that your integration can interact with the REST API
  3. Make a test API Request in test mode to confirm that everything is working.

Be sure to refer to our comprehensive API Reference as you navigate through this guide.

Generate your API Key

The REST API uses an API Client ID and API Secret to authenticate requests. You can create, view and manage your Client ID and Secret in the Control Panel.

🚧

API Key Security

Your API Credentials carry many privileges and your Secret cannot be accessed after creation, so be sure to keep them secure! Do not share your secret API credentials in publicly accessible areas such as GitHub, client-side code, and so forth.

All API requests should be made over HTTPS. Calls made over plain HTTP will work but are not recommended. API requests without authentication will fail.

The RESTful API authenticates HTTP requests using tokens, which are generated using your API credentials. Each token is valid for 24 hours from creation, after which they expire and a new token will need to be generated.

To generate a token, BASE64 encode your API credentials in the format ClientID:APISecret and include them in the Basic Authentication Header.

Start Building

We provide step by step recipes to walk you through code samples in different programming languages. You're also welcome to skip ahead and refer directly to our API Reference.

Send SMSes using C#
Open Recipe
Send SMSes using Java
Open Recipe
Send SMSes using PHP
Open Recipe
Send SMSes using Python
Open Recipe
Send SMSes using Node.JS
Open Recipe
Send SMSes using Go
Open Recipe
Send SMSes using Ruby
Open Recipe
Send SMSes using Powershell
Open Recipe

The above recipes contain examples of a basic SMS send. Please view the API Reference for all available features.

Make a Test API Request

To check that your integration is working correctly, send a message with the testMode parameter set to true and ensure that we return a successful response to your API request.

Now you’re ready to go live and start sending!

Updated over 1 year ago