Manage API tokens
Create, update, deactivate, and delete API tokens in the dashboard. API tokens cannot manage other API tokens.
You manage API tokens in the dashboard under Developers > API Tokens. Managing tokens requires the Developer permission: viewing tokens needs view access, and creating, updating, and deleting tokens needs edit access.
An API token cannot create, list, view, update, or delete API tokens. Requests to /api/{account_id}/api-tokens that authenticate with a secret token return 403 with API keys cannot manage API keys. Use the dashboard. This stops a leaked token from creating more tokens or re-enabling revoked ones.
Token types
Each API token bundles two credentials:
Both live and sandbox accounts use the _prod_ prefix in production. The token record itself is identified by an id with the tkn_ prefix (e.g., tkn_prod_a1b2c3d4e5f6g7h8).
The full secret token is shown only once, when you create the token. Store it securely — it cannot be retrieved again. After that, the dashboard shows only a preview (the first 12 characters, e.g. st_prod_secr...) for identification.
Create a token
- Go to Developers > API Tokens and create a new token.
- Optionally enter a Description and an Expires at date. Without an expiry date, the token does not expire.
- Click Create API token, then copy the secret token and store it securely.
Deactivate or delete a token
- Deactivate a token to stop it from authenticating right away. Any call that uses its secret token is rejected with
401. The token stays in your list for audit purposes, and you can Activate it again later. - Delete a token to remove it permanently. This cannot be undone.
Rotate a token
Rotate a credential by creating a replacement and then retiring the old one:
- Create a new token and deploy its
secret_tokento your integration. - Verify the new token works in production.
- Deactivate the old token (reversible), or delete it (permanent).
Deactivating first and deleting only after a grace period lets you roll back quickly if the new token was misconfigured.
Set an expiry date when you create a token to enforce a rotation schedule.