Bulk-import leads into a new auto-created list.
POST/api/v1/leads/bulk
Upserts up to 1000 leads in a single call. Auto-creates a lead_list row scoped to the tenant so the in-list unique index (tenant_id, list_id, phone) handles dedupe. The returned list_id can be used as the target of a subsequent /v1/campaigns create call. Scope: write_crm.
Request
Responses
- 200
- 400
- 401
- 403
- 429
Import result
Missing or invalid parameters
Invalid or missing API key
API key lacks the required scope for this endpoint
Rate limit exceeded
Response Headers
X-RateLimit-Limit
X-RateLimit-Remaining
X-RateLimit-Reset
Retry-After