Tokens

2. Authentication Tokens

In order to communicate with the Integration Hub, you must setup a ‘token’. This identifies the API call as belonging to your company. API Tokens are unique values generated by the Integration Hub that you pass as part of your API call. They are 38 characters long are generated using an algorithm based on 2 securely generated random numbers^{^[1]}. An example token likes like this:

1133srk2y0wjw18pwbri1vsnfpj19ul4svhr01

Tokens are used in preference to passwords as they can be controlled independently of usernames and passwords, and cannot be easily guessed.

2.1. Generating a token

From the Settings menu, choose the API Credentials menu option.

On the API Credentials page you can see all the API tokens that are currently in use. To generate a new token, click “Generate API Token”

This will generate a new token which can be used immediately. You can generate as many tokens as you need and optionally provide a description for the token. (This is not used by the Integration Hub but is provided as a way of tracking where you are using the tokens)

[1] The probability of generating the same token is very small. (There are about 10⁴³ possible values)