Best Practices
Performance
Use PATCH for incremental updates and avoid resending unchanged large text/media fields.
Retries
Retry only retryable errors with backoff and stable idempotency identifiers.
Outbound Webhooks
Production outbound delivery is unavailable; use sandbox simulations only.
Large Imports
Batch in CRM-side queues and monitor API Logs, Usage and Rate Limits.
Media Upload
Send media URLs in canonical slots; do not embed binary files in JSON.
Security
Use HTTPS, rotate compromised secrets and never expose signing secrets in browsers.