Skip to main content

Authentication

To use the APIs, you need to make a request to the authentication server to obtain a valid Access Token.

Request a service account​

You need to request the creation of a service account from the project manager responsible for your account. After creating the account, an e-mail is sent containing the data required for authentication:

  • Account name;
  • Your company identifier (Tenant ID);
  • Key ID;

This information is used to generate the JWT.

Generate a JWT (JSON Web Token)​

To obtain a valid Access Token, you must send a JWT in the request to the authentication server. This JWT is made up of three coded blocks (header, payload and signature), separated by the . (period) character. For more information, see Creating the JWT.

Make a request to obtain the access token​

After generating the signed JWT, make a request to the authentication platform. For more information, see Requesting an access token

Use the access token to call the APIs​

With a valid access token, simply call the APIs using this token in the header of your requests, in the Authorization parameter.

Any concerns?​

Missing something or still need help? If you are already a customer or partner, you can contact us through the Help Center.