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)