API Key Management & Security
API keys allow your applications to authenticate with the Chatofy API. Keys are AES-256-GCM encrypted at rest and scoped to specific permissions.
Generating an API Key
- Navigate to Settings → API
- Click "Generate New Key"
- Enter a name for the key (e.g., "Production App")
- Select the permission scopes required
- Click "Generate"
- Copy the key immediately — it will not be shown again
Important Security Note
API keys are displayed only once at creation. If you lose a key, you must revoke it and generate a new one. Store keys securely, preferably in a secrets manager or environment variables.
Permission Scopes
messages:send— Send messages via APIcontacts:read— Read contact datacontacts:write— Create and update contactscampaigns:read— View campaign datacampaigns:write— Create and manage campaignstemplates:read— View message templatesanalytics:read— Access analytics data
Revoking API Keys
To revoke a key, go to Settings → API, find the key in the list, and click "Revoke". The key will be immediately invalidated. Any service using this key will stop working.