Skip to main content

​
What Tokens Do

API tokens identify your requests to Handled. Include them in the Authorization header of every API call.

​
Create a Token

1

Open Settings

Log into Handled and go to Settings > API Tokens
2

Create

Click Create API Token
3

Name

Enter a name (for your reference)
4

Generate

Click Create API Token
5

Copy

Copy the token immediately
6

Confirm

Confirm you’ve copied it
7

Done

Click Done
The token is only shown once. Make sure to copy it before closing the dialog.

​
Security

Store Securely

Treat tokens like passwords

Don't Share

Anyone with your token can access your account

Use HTTPS

All API requests require HTTPS

Separate Tokens

Create different tokens for different environments

​
Using Tokens

Include in every request:
Example:

​
Token Management

  • Create multiple tokens for different purposes
  • Delete tokens you no longer need
  • Rotate tokens periodically for security