API tokens
Create API tokens that an agent can safely use
API tokens authorize a person, integration, or coding agent to act on your Clarvivo account. They are private credentials. Treat them like a password, not like the project’s public browser tracking key.
Create a token
- 1
Open API tokens
Go to Dashboard → Account → Settings → API tokens. - 2
Name the token
Use a name that explains who or what will use it, such as ‘Claude Code on marketing site’ or ‘weekly reporting script’. - 3
Choose the minimum scopes
Give an agent only the reads or writes it needs. For example, analytics reporting needs analytics:read, while an event-setup workflow also needs events:write. - 4
Copy it once
The plaintext token is shown once at creation. Store it in the client’s secure environment configuration, never in source code.
Available scopes
Scopes include project read/write, analytics read, revenue read, funnel read/write, event write, alert write, and Search Console read. The MCP checks scopes and tells you which one is missing instead of silently guessing.
Revoke when the context changes
Revoke a token when a teammate leaves, an integration is retired, a laptop or repository is exposed, or you no longer want an agent to have access. Create a new scoped token rather than reusing a token in a different context.