How to Create API Tokens

Raquel Updated by Raquel

To maintain uninterrupted access to the Turn.io API while integrating external systems, it's important to manage your authentication tokens carefully. One of the safest ways to generate a new token without invalidating existing ones is to use the Turn.io platform’s user interface instead of the API.

Creating a Token via the Turn UI

To create a new token:

  1. Log into the Turn.io platform.
  2. Go to Settings > API & Webhooks.
  3. Scroll down to the Authentication Tokens section.
  4. Click “Create a Token”.
  5. Provide a clear and descriptive name, and set the expiration date.

This method allows you to manage tokens without disrupting services that are currently using the existing token.

Using Your Token

Turn.io requires the access token to be included in all API requests using the following header format:

Authorization: Bearer <your_token_here>

What to Do When a Token Is About to Expire

Before a token expires, Turn will send a reminder noting:

"This token was likely generated by your technical team to integrate external systems with Turn’s API. One of your organisation’s admins will need to create a new token and update any connected systems to ensure continued functionality."

To avoid disruption:

  • Create a new token following the steps above.
  • Update any services or code using the old token with the new one.
  • Once everything is updated, delete the old token using the trash icon.

What If You Don’t Update the Token?

If the token expires and isn’t replaced, Turn.io’s core platform features will continue to work. However, any external systems connected via the API may stop functioning correctly.

Need Help?

If you have any questions or need assistance, contact the Turn.io Support team.

Was this article helpful?

Why use Turn.io's Interface instead of API only?

How to mark messages as read

Contact