> ## Documentation Index
> Fetch the complete documentation index at: https://dev.gomega.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Notable changes to the MEGA public CRM Lead API.

<Update label="2026-07" description="Initial public release">
  The first public release of the CRM Lead API.

  * **Pull** — `GET /api/agents/crm/leads` with status/stage/search/date filters, `lead_line`, optional `custom_fields`, and cursor (keyset) pagination via `next_cursor`.
  * **Push** — `POST /api/agents/crm/leads` (single) and `POST /api/agents/crm/leads/bulk` (up to 500 rows, `dry_run`, `on_duplicate`, per-row results, `unknown_custom_fields`), both idempotent via `Idempotency-Key`.
  * **Webhooks** — register/list/update/delete lead webhooks; HMAC-SHA256 signed `lead.created` deliveries (`X-Mega-Signature` / `X-Mega-Timestamp` / `X-Mega-Delivery`) with retries and SSRF-validated URLs.
  * **Rate limits** — `RateLimit-*` headers on every response and `429` + `Retry-After` on overage (60/min + 1,000/hour default; 10/min for bulk).
  * **Scoped, customer-locked keys** — `public_api:leads:read`, `public_api:leads:write`, `public_api:webhooks:manage`.
</Update>