Create leads
Create one lead, import many rows, or import chosen results of a prospect search.
Send lead fields for one lead, rows for an import, or search_id with prospect_keys
(people search) or place_ids (map search). Use an idempotency_key so a retry is safe.
For a big people search send search_id with import_all, or import_count for the first N (more than 100
prospect_keys also works). That starts a background import, answers with a job id, and GET /jobs?id= follows
it. lookup_email and lookup_phone find contact details as people are added. They stop at the workspace’s
daily lookup limit: the people are still added and the job shows how many still need details. This operation can change workspace data or trigger an external side effect; review the request before sending it and do not retry blindly after a timeout.
Body
Response
Successful Response