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.

ScopeGranted to rolesAllows
apikey:manageadmin, ownerCreate, rotate and revoke API keys.
billing:manageownerBilling actions and owner role changes (owners only).
enrichment:readadmin, member, ownerRead enrichment jobs and their results.
events:readadmin, member, ownerRead the event log.
export:createadmin, member, ownerCreate exports (spends credits); implies export:read.
export:readadmin, member, ownerRead exports and download their files.
job:manageadmin, member, ownerUpload bulk files and cancel bulk jobs; starting one also needs lead:lookup (match) or lead:enrich (enrich). Implies job:read.
job:readadmin, member, ownerRead bulk jobs and download their result and error files.
lead:enrichadmin, member, ownerSubmit asynchronous enrichments (spends credits); implies enrichment:read.
lead:lookupadmin, member, ownerSynchronous organization lookup and match (spends credits).
lead:readadmin, member, owner, viewerRead leads, notes, interactions and lists.
lead:writeadmin, member, ownerCreate and modify leads, notes, tags, lists, opportunities and suppressions.
list:manageadmin, member, ownerManage lists and their members; implies list:read.
list:readadmin, member, ownerRead lists and their members.
member:manageadmin, ownerManage members and invitations.
product:manageadmin, ownerManage products, ICPs and fit rules.
search:createadmin, member, ownerCreate, cancel and estimate searches, campaigns and enrichment cost.
search:readadmin, member, owner, viewerRead searches, results and campaigns.
tenant:manageadmin, ownerChange tenant settings.
tenant:provisionplatform onlyPartner provisioning of child tenants and credit transfers. Granted only to API keys created by a platform administrator.
usage:readadmin, member, owner, viewerRead credits, usage, billing and plan limits.
watchlist:manageadmin, member, ownerWatch and unwatch organizations and saved searches; implies watchlist:read. Watching a saved search also needs search:create because each re-run spends credits.
watchlist:readadmin, member, owner, viewerRead the watchlist.
webhook:manageadmin, ownerManage webhook endpoints and redeliveries.