Scopes
An API key carries explicit scopes; grant only what the integration needs. A write scope implies the matching read scope (list:manage reads lists, export:create reads exports, lead:enrich reads enrichments). GET /v1/scopes returns the same catalog live.
| Scope | Granted to roles | Allows |
|---|---|---|
| apikey:manage | admin, owner | Create, rotate and revoke API keys. |
| billing:manage | owner | Billing actions and owner role changes (owners only). |
| enrichment:read | admin, member, owner | Read enrichment jobs and their results. |
| events:read | admin, member, owner | Read the event log. |
| export:create | admin, member, owner | Create exports (spends credits); implies export:read. |
| export:read | admin, member, owner | Read exports and download their files. |
| job:manage | admin, member, owner | Upload bulk files and cancel bulk jobs; starting one also needs lead:lookup (match) or lead:enrich (enrich). Implies job:read. |
| job:read | admin, member, owner | Read bulk jobs and download their result and error files. |
| lead:enrich | admin, member, owner | Submit asynchronous enrichments (spends credits); implies enrichment:read. |
| lead:lookup | admin, member, owner | Synchronous organization lookup and match (spends credits). |
| lead:read | admin, member, owner, viewer | Read leads, notes, interactions and lists. |
| lead:write | admin, member, owner | Create and modify leads, notes, tags, lists, opportunities and suppressions. |
| list:manage | admin, member, owner | Manage lists and their members; implies list:read. |
| list:read | admin, member, owner | Read lists and their members. |
| member:manage | admin, owner | Manage members and invitations. |
| product:manage | admin, owner | Manage products, ICPs and fit rules. |
| search:create | admin, member, owner | Create, cancel and estimate searches, campaigns and enrichment cost. |
| search:read | admin, member, owner, viewer | Read searches, results and campaigns. |
| tenant:manage | admin, owner | Change tenant settings. |
| tenant:provision | platform only | Partner provisioning of child tenants and credit transfers. Granted only to API keys created by a platform administrator. |
| usage:read | admin, member, owner, viewer | Read credits, usage, billing and plan limits. |
| watchlist:manage | admin, member, owner | Watch and unwatch organizations and saved searches; implies watchlist:read. Watching a saved search also needs search:create because each re-run spends credits. |
| watchlist:read | admin, member, owner, viewer | Read the watchlist. |
| webhook:manage | admin, owner | Manage webhook endpoints and redeliveries. |