Skip to content

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.

  1. Open the user menu (your initials, top right) → Settings → Agents.
  2. Click New agent.
  3. Enter a Name (e.g. Nana), and optionally a Title (e.g. Chief Sales Officer) and What it does.
  4. Click Create.
  1. On the agent’s card, click New key.
  2. Under What this key can do, tick the permissions it needs. By default: read records, create and update records, and send feedback.
  3. Optional: choose an expiry date in Expires. Leave it empty for a key that never expires.
  4. Click Create key.
  5. 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.
  6. Store the key in your agent’s secrets and click I’ve stored the key.

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 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.