API tokens
An API token lets one of your own systems, like a CRM or a script, use the linkable.id API in one workspace. You find them in Settings → API tokens if your account's plan includes the API (Business, Agency and Enterprise; ask us to turn it on) and your role allows creating tokens, or you're a super admin.
API reference
The API reference section at the top of the page shows the API's base URL (https://{admin-domain}/api/v1) with a button to copy it, and Download OpenAPI document, the file that describes every endpoint for Postman, Insomnia or a client generator. See Public API for a quick start.
Creating a token
- Choose Create token.
- Give it a name you'll recognize later, such as the system that will use it.
- Pick its permissions. Only the ones your own role allows are offered, so a token can never do more than you can.
- Choose when it expires: 30, 90 or 365 days.
The token is shown once. Copy it straight into the system that needs it or a password manager. If you lose it, revoke it and create a new one.
What a token can reach
- Only the workspace it was created in.
- Only the permissions you picked, and only while your role still allows them.
- Nothing at all once it expires or is revoked, or when you leave the workspace.
- Nothing while your account requires two-factor sign-in and you haven't set it up.
A token can't be used to connect Claude. Use Connect Claude for that.
To start calling the API with your token, see the Public API guide.
Expiry and revoking
You get an email a week before a token expires. Revoke stops a token immediately. A super admin sees every token in the workspace and can revoke any of them. If your role no longer lets you create tokens, you still see your live ones here and can revoke them.
You can hold up to 10 active tokens per workspace.
With Claude
Claude can't manage API tokens yet: that stays in the panel.