Skip to main content

GET /v1/crm/leads

GET/v1/crm/leads
scope: crm.read 0 credits

List the leads of the key's client with their CRM fields. Paginated (limit 1 to 100, default 50) and incremental with updated_since + next_cursor. Filters: classification (comma separated), phase (comma separated), has_next_action (true/false). sort: last_activity_desc (default: newest real reply or sent mail first) or updated_at (oldest change first, for sync with updated_since). Only leads the client sees in its portal (never out-of-office or spam).

Requires a key locked to one client with crm.read granted explicitly, and the CRM API enabled for the account (otherwise 403 feature_not_enabled). Writes: max 60 per minute per key (429 crm_write_rate_limited). See CRM sync.

Response 200​

{ "data": [ { "id": "5f0c…", "email": "anna@acme.com", "phase": "proposal", "crm_updated_at": "2026-10-01T14:03:00Z" } ], "next_cursor": "MjAyNi0x…", "has_more": true }