API keys authenticate requests to the Run a Call REST API. Generate them in Settings → Integrations → API. Only Owner can create keys.

Open the API page

Go to Settings → Integrations → API, then click + New API key.

Fill in the fields

FieldWhat it controls
LabelWhat this key is for — "Zapier production", "Internal CRM sync". Helps you identify it later.
ScopesWhich API resources this key can read/write (customers, jobs, invoices, etc.)
Rate limit (per minute)How many requests per minute. Conservative default; raise for high-throughput integrations.
IP allowlistOptional list of IPs that can use this key. Recommended for production keys.
Expires atOptional. Set to auto-revoke on a date.

Generate and copy the key

Click Generate.

Warning

Copy the full key now. It's shown once and not visible again — only the prefix (e.g. rak_live_a3f2…) is stored for reference.

What scopes do

Each scope limits what API endpoints the key can hit. Common scopes:

ScopeAllows
customers:read / customers:writeRead or write customer records
jobs:read / jobs:writeRead or write jobs
invoices:read / invoices:writeRead or write invoices
pricebook:readRead pricebook items
webhooks:writeCreate or update webhook subscriptions
Tip

Best practice: least privilege — give each key only the scopes it needs. A reporting key probably only needs :read.

Revoking a key

If a key is compromised (or you no longer need it):

  1. Settings → Integrations → API.
  2. Find the key.
  3. Revoke.

Revoked keys stop authenticating immediately. The key record stays in the list (greyed out) for audit purposes.

What you'll see in the list

ColumnWhat it shows
LabelThe name you gave the key
Key prefixFirst few characters
ScopesPermissions granted
Rate limitRequests per minute
Last usedTimestamp of most recent request
StatusActive, revoked, or expired
Created atWhen the key was generated

What's NOT yet built

  • Key rotation without re-generating a new key from scratch.
  • Usage analytics per key (request counts, errors).
  • Webhook secret rotation through this same UI.