Scopes, expiry, rotating, and revoking tokens

Control what each API key can do: limit permissions with scopes, set an expiry date, rotate it, or revoke it when you no longer need it.

Jun 26, 2026

Watch this step in the video · Scopes: what the key can do

Once you know how to create an API key, the next step is managing its lifecycle securely: grant only the permissions it needs, let it expire, rotate it periodically, and revoke it when it's no longer used.

Scopes (permission boundaries)

Scopes define what the key is allowed to do. In the editor they're grouped:

  • Contacts: read:contacts, write:contacts
  • Messages: read:messages, write:messages (send messages)
  • Channels: read:channels
  • CRM: read:crm, write:crm
  • Projects: read:projects, write:projects
  • Webhooks: manage:webhooks
  • Full access: admin (all scopes)

If you leave every scope unchecked, the key gets full access (equivalent to *). For security, check only the permissions the integration needs — the principle of least privilege.

Expiry

Under Expires at you can set a date and time. When that moment arrives, the key stops authenticating automatically. Leave it empty and the key never expires until you delete it. We recommend expiry dates for third-party or test credentials.

Rotating a key (Regenerate)

Rotating means replacing the secret while keeping the same configuration (name, scopes, workspace, expiry).

  1. Open API Keys and click Edit on the key.
  2. Click Regenerate.
  3. The old key is revoked and a new one is issued. Copy the new value from the "Copy and save now" dialog (shown only once).
  4. Update the integration with the new token.

Important: when you regenerate, the previous key stops working immediately. Schedule the change so you don't break the service.

Revoking (deleting)

Omnifox has no "inactive" state: revoke = delete.

  1. In the API Keys list, find the key.
  2. Click Delete and confirm.

The key stops authenticating at once and cannot be recovered.

Best practices

  • Rotate production keys on a schedule (for example, every 90 days).
  • Revoke any key you suspect is compromised right away.
  • One key per integration, with minimal scopes and a clear name.

If it doesn't work

  • My integration broke after regenerating: it's still using the old token. Load the new value.
  • I can't see the Regenerate/Delete button: you need the Manage API keys permission.

Related articles

Was this helpful?

Related articles

Message us on WhatsApp