API Tokens

The following provides instructions on how to generate a new token on the CloudBlue Connect platform, describes available operations within the Tokens section of the Integrations module and showcases how to use your generated token.

Creating Tokens

Navigate to the Tokens section from the Integrations module on the Connect platform.

Click the Create Token button to launch a token creation wizard.

Follow the wizard steps to successfully configure a new token.

1. General

Specify the following general token properties:

• Name: Enter your token name.
• External ID: Specify an external identifier for your token (optional).
• Description: Provide a description for your token.

Click Next to continue.

2. Expiration

Select an expiration date for your token from the preset list, a custom expiration date, or allow for perpetual validity

3. Extension

Select an extension for your token from the following list (selection is updated at CloudBlue’s discretion):

• Flowgear: Select this extension to create a new token for the Flowgear iPaaS platform.
• Reports: Choose this extension to generate a token for Custom Reports creation.
• Zapier: Select this extension to create a new token for the Zapier workflow automation platform.
• Custom: Choose this option for your custom integration.

4. Permissions

Depending on your token type, the system can ask you to configure permissions for your token. Therefore, the system will allow your token to access only your specified modules on the CloudBlue Connect platform.

Select required modules for your token by using corresponding checkboxes or check the All Modules checkbox to choose all available modules on Connect.

Click the Create button to finalize your token creation.

5. Summary

As a result, the system provides a summary with your token configurations.

Click the Go to Details button to access the token details screen. Otherwise, click Close to return to the Tokens section.

Token Management

The Tokens section displays a list of your created API tokens. Furthermore, this section provides various token data, such as your specified token name, selected extension, creation date, status, and more. Note that you can click on the vertical ellipsis (⋮) button to disable/enable or delete your token.

Token Details

Click on your token name to access the Token Details screen. This screen includes General, Statistics, and Permissions tabs and allows editing your selected token.

The General tab provides your API Key/Handle that is required for the integration operation, your specified description, extension description, etc. View or copy your API Key/Handle by using corresponding buttons on the user interface.

The Statistics tab shows a statistical graph of the responses to the token within the last 30 days. These tokens are categories within the 200, 300, and 400 code responses. The codes can be described as the following:

• 200s – Success: The request has been received and works well.
• 300s – Redirection: The request has been received but needs a extra step to be completed.
• 400s – Client error: The request has been asked by a client but the destination page is not correct

The Permission tab, as the name implies, allows reviewing selected permissions for your token. The Enabled status indicates that the corresponding module is available for your token.

Click the Edit button at the top-right corner of the screen to change your token properties and permissions. Note that you can also click on the vertical ellipsis (⋮) button to disable/enable, rotate, renew (if applicable) or delete your token.

Using API Tokens

To use a particular API token for Connect API authentication, copy the API Key/Handle value from the Token Details screen and paste it within the HTTP Authorization Header of your API requests.

For example, get your agreements list by using the following request with copied authorization value:

GET /agreements/
Authorization: ApiKey SU-160-984-311:f45bee7e79b10ff6eff67902ccb4f3d46724ceb8

Refer to the REST API documentation to learn more about Connect API.

Furthermore, note that this value is required for integration with available extensions for the CloudBlue Connect platform. Refer to the Extensions article for more details.