Create an agent and an API key
Owners and admins do this in Settings → Agents: create the agent, then a key, then paste the key into your agent.
Create an agent
Section titled “Create an agent”- Open the user menu (your initials, top right) → Settings → Agents.
- Click New agent.
- Enter a Name (e.g. Nana), and optionally a Title (e.g. Chief Sales Officer) and What it does.
- Click Create.
Create a key
Section titled “Create a key”- On the agent’s card, click New key.
- Under What this key can do, tick the permissions it needs. By default: read records, create and update records, and send feedback.
- Optional: choose an expiry date in Expires. Leave it empty for a key that never expires.
- Click Create key.
- Copy the key now. This is the only time Mety shows it. The dialog also gives ready-to-paste snippets: Claude Code (MCP), MCP config (JSON) and Test with curl.
- Store the key in your agent’s secrets and click I’ve stored the key.
Permissions
Section titled “Permissions”Each permission is shown with its code:
- Read organizations, contacts, deals, activities and metrics (
records:read) - Create and update records, deals, activities and links (
records:write) - Delete records and activities permanently (
records:delete) - Create and edit pipelines and stages (
pipelines:manage) - Define, edit and delete custom fields (
fields:manage) - Send feedback to the Mety team (
feedback:write) - Read the audit log (
audit:read)
Give only what the agent needs. Permanent deletion can’t be undone, and agents rarely need it: archiving is reversible.
Revoke a key or archive an agent
Section titled “Revoke a key or archive an agent”- Revoke next to a key stops it at once: the agent gets errors from then on. You can’t undo it, but you can create a new key.
- Archive agent revokes all its keys at once. Show archived agents lists archived ones.
Each key shows when it was created, when it was Last used, and when it expires.
- If you lose a key, revoke it and create another.
- On the Free plan an account can have one active API key. App connections (Claude, ChatGPT, Grok) don’t count. See Plans and limits.
- How to use the key in code: see the Developers Center.