Developers

API keys

Create, scope and revoke the workspace keys used by the MCP server and the REST API.

API keys let Claude, Cursor, Clay, n8n or your own code act on one workspace. Only admins can create or revoke them.

Settings, API: keys, and a reference with ready-to-copy examples for every endpoint.

Create a key

  1. Go to Settings, API.
  2. Name the key after where it will be used (Claude, Clay, n8n), so you know what to revoke later.
  3. Choose Read and write or Read only, then click Create key.
  4. Copy the key (it starts with echo_sk_) and click I saved it. It is shown once; Echo keeps only a fingerprint.
The new key is shown once.

Access levels

Read onlyRead and write
List and read campaigns, leads, groups, designs, signals, linksYesYes
Import leadsNoYes
Create (publish) campaigns, spending AI on your keyNoYes
Send links into your sequencerNoYes

Good practice

  • One key per tool or person. The table shows each key's Last used date.
  • Store keys in your secret manager or environment variables (ECHO_API_KEY), never in code or shared docs.
  • Revoke stops a key at once. Anything using it gets 401 from then on.
  • Limits: 120 requests a minute per key, up to 20 active keys per workspace.

Next: MCP server or REST API.

Something unclear or missing? Email support@relevanceai.io and we will fix the page.