Skip to main content

​
Bearer Token

All API requests require a Bearer token in the Authorization header: 
Authorization: Bearer <your-api-token>

​
Getting Your Token

1

Log In

Log into your Handled dashboard
2

Navigate to Settings

Go to Settings > API Tokens
3

Create Token

Click Create API Token
4

Copy Token

Copy and store the token securely
The token is only shown once. Make sure to copy it before closing the dialog.

​
Example Request

curl 'https://api.usehandled.io/api/v1/ipaas/integrated-accounts' \
  -H 'Authorization: Bearer sk_live_abc123...' \
  -H 'Content-Type: application/json'

​
Security Best Practices

Keep Tokens Secret

Anyone with your token can access your account. Never commit tokens to version control.

Use HTTPS

All requests must use HTTPS. HTTP requests are rejected.

Separate Environments

Create separate tokens for development, staging, and production.

Rotate Regularly

Periodically rotate tokens for enhanced security.

​
Environment Variables

Store your token in an environment variable: 
export HANDLED_API_TOKEN="sk_live_abc123..."
Then use it in your requests: 
curl 'https://api.usehandled.io/api/v1/ipaas/integrated-accounts' \
  -H "Authorization: Bearer $HANDLED_API_TOKEN"