Security Service API

Why use this API?

Use the Security Service API to request authentication tokens to use in all other Clickatell API calls.​

Participating parties

See here for definitions.

• Clickatell

• Client

Getting started with Security Service API

To interface with Clickatell, the following needs to be set up, configured, and tested:

1

Get client_id and client_secret

Clickatell will securely provide you with a client_id and client_secret during integration and setup

A unique client_secret will be provided for Sandbox (testing) and Production environments respectively.

2

Request a token

Request a token with your client_secret and client_id.

This API requests a temporary access_token and API_key that must be supplied in the header of all API calls to Clickatell.

3

Use the token in API calls

Use the API_key and access_token in all other API call headers to Clickatell while the token has not expired (see the field expires_in).

A token is reusable, and your system should only request a new token in the following cases:

• Ten seconds before your current token is about to expire.

• If the token has already expired.

If your client_secret is compromised, contact Clickatell urgently and request a new client_secret.

A high-level view of this interface.