API: Keys and authorization
Getting started
Reference
Keys and authorization
Updated September 7, 2026
All API requests are signed with a company key. Keys are created in the dashboard on the Business plan and grant access to all company data — treat them like passwords.
Creating a key
- 1
Open Settings → API
Available to the owner and admins on the Business plan.
- 2
Create a key
Click “New key” and name it — e.g. “Bitrix24” or “backup”. The name helps you remember where the key is used.
- 3
Save the key
The ch_live_... key is shown in full only once. Store it in a secrets manager right away.
How to pass it
Header
Authorization: Bearer ch_live_9f3ka2Never put the key in browser code, mobile apps or repositories. Server-side only. Revoke a compromised key in the dashboard — it stops working instantly.
Rotation and revocation
- You can have several keys — issue a separate key per integration.
- Revocation is instant: requests with a revoked key get 401.
- Rotate keys every 6–12 months: create a new one, migrate the integration, revoke the old.