Use a service account for scripts, scheduled jobs, and integrations that need company-owned REST API access. It has its own permissions and workspace grants, and keeps working when its creator leaves.
Open Settings and go to General → Service accounts under the organization or workspace you administer.
| Your role | Where | Accounts you can manage |
|---|---|---|
| Organization owner or admin | Organization → General | All accounts, with access to one or more workspaces |
| Workspace admin | Your workspace → General | Accounts restricted to that workspace |
Members without an admin role cannot create accounts or manage keys.
Send it as Authorization: Bearer <key>. See API access for endpoints and examples. Service-account keys work with REST, not MCP.
Access is limited to assigned workspaces and granted scopes. The account does not inherit its creator's permissions. Defaults are ticket read and public-only knowledge read.
| Scope | Grants |
|---|---|
| knowledge:read:public | Search and read articles published for anonymous access |
| knowledge:read | Search and read all collections in assigned workspaces, including restricted collections |
| tickets:read | List and read tickets |
| tickets:write | Create and update tickets |
| tickets:delete | Delete tickets |
For knowledge, choose None, Public only, or Normal read. Ticket scopes are independent: write and delete do not include read.
Use Edit access to change permissions or workspaces. Reductions take effect on the next request. Keys retain their original scope ceiling, so adding a scope requires a new key. Accounts spanning multiple workspaces are managed from organization settings.
Keys expire after 30, 90, or 365 days, or have No expiration. The default is 90 days. The account itself does not expire; keys do not renew automatically.
To rotate, create a replacement in Manage keys, update your integration, then revoke the old key. Revocation takes effect on the next request. To pause all keys, clear Account enabled in Edit access. Re-enabling restores unexpired, unrevoked keys.
Each service account has a separate budget of 120 reads and 30 writes per minute by default. All its keys share that budget across workspaces. It is separate from regular users' budgets, including its creator's. Creating or rotating keys does not increase it.
Over the limit, the API returns 429. Wait for the seconds in Retry-After before retrying.