API v1
Authentication
All v1 requests require an API key. Keys are scoped to a single chatbot — one key can only query the chatbot it was created for.
Authorization header
Send the key as a Bearer token in the Authorization header on every request.
text
Authorization: Bearer cm_live_YOUR_API_KEYGetting your API key
- Go to your chatbot dashboard.
- Select a chatbot and navigate to the API tab.
- Click Create API Key, give it a name, and copy the key immediately — it’s shown only once.
Key format
All keys start with cm_live_ followed by 32 alphanumeric characters. You can rotate or revoke keys at any time from the dashboard.
Each key carries optional metadata you can configure on creation:
- Allowed IPs — restrict requests to a list of source IPs. Empty list = no restriction.
- Expiry — optional expiration timestamp after which the key returns 401.
- Revoked at — manually revoking the key takes effect immediately.
Plan availability
API access is available on Plus and Enterprise plans. Free and Go plans do not include API key support. View pricing.
Related