Start here
- Authentication options: inbound webhooks vs OAuth apps — and when each is right
- The core CRM object model: leads, deals, contacts, companies, and SPA items
- Reading data at scale: list methods, pagination with the start parameter, and filters
- Writing data safely: add/update methods, custom fields (UF_CRM_*), and idempotency
- batch: bundling up to 50 calls per request — the single most important scaling tool
- Events: event.bind and outgoing webhooks for reacting to CRM changes
Production topics
- Rate limits and operating limits: backoff strategies and queue design
- Error handling: transient vs permanent failures, retries, dead-letter queues
- Field mapping discipline: source attribution, phone normalization, defaults
- Logging: what to record (and what never to log — webhook URLs contain secrets)
Official SDKs: Python and PHP
- B24PySDK — Bitrix24's official Python SDK: authorisation via incoming webhooks or OAuth, request and parameter validation, batch requests, unified error handling, and helpers for Django, FastAPI, and Flask
- B24PhpSDK — the official PHP SDK, the natural choice for PHP back ends and local apps
- Use an SDK for new projects instead of hand-rolled HTTP calls — you get pagination, batching, and errors handled consistently
- Whatever the language, respect the REST limits: about 2 requests/second on standard cloud plans, 5 on Enterprise, and batch up to 50 commands per call