An API token lets a script, integration, or AI assistant act as you, limited to the permissions you choose. Tokens work for the REST API and for connected AI tools.
Find them
Any of these opens the same page:
- Settings → API tokens on the Settings hub.
- Settings → Developer, then API tokens in the Developer menu.
- Press
Cmd+Kand search for "API tokens" (see Search and the setup guide).
The page lists each token with its Name, Permissions, Last used, and Expires. Use the search box to find one.
Create a token
-
Choose Create token.
-
Enter a Name that says what the token is for, such as "Zapier" or "Reporting script".
-
Pick Permissions:
- Read forms and responses
- Create submissions
- Edit and publish forms
- Reply in Desk
Open Fine-grained permissions for the full list of abilities.
-
If you chose a CRM permission, you can set Work with CRM records as to a role such as Viewer. The token then reaches only the objects, fields and records that role may reach, and never more than you can. Use it to give a script less than your own access. You can only pick a role that can do no more than you can; the owner can pick any. The same choice is offered when you connect an AI assistant (the manual token and the approval of a device sign-in), and the agent tool that connects a client, the sandbox workspaces API and the mobile developer tokens take a
crm_roleas well. -
Choose when it Expires: in 90 days, in 1 year, or never.
-
Create the token and copy it straight away. For your security it is not shown again.
Keep it in a password manager or secrets store. Give each tool its own token with the least permissions it needs, so you can revoke one without breaking the rest.
Change or revoke a token
- Edit the permissions, and the role it works as, of an existing token from its row. Taking away its CRM permissions removes the role.
- Revoke deletes a token. Anything using it stops working immediately until you paste in a new token.
Next
- API authentication → - send a token with each request
- Tokens & abilities → - what each ability allows
- AI assistants (MCP) → - connect Claude, Cursor, and others
