Import leads
Stage your own single-kind people or company rows from a CSV export, conference list, or scrape.
Tool: import_leads
Mixed input is rejected; invalid-identity rows are returned as invalid staged results instead of creating partial CRM records. Review the search_id, then use save_search to create exactly one group or append approved rows. NOT for: leads already in the CRM → add_leads_to_group (by id).
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
rows | array of lead objects | yes | Single-kind rows only; mixed people/companies are rejected. Fixed columns: entity (person|company, optional - inferred from the fields), full_name, first_name, last_name, email, linkedin_url, title, company_name, company_domain, custom (object for extra fields). Person rows need email or linkedin_url; company rows need company_domain. Unknown columns are a validation error. |
Returns a staged
search_id; no CRM row or lead group is created untilsave_search.Invalid-identity rows stay visible as invalid staged results so the agent can explain exactly what must be fixed.
NOT for leads already in the CRM - attach those by id with
add_leads_to_group.
Sample request
{
"rows": [
{
"full_name": "Dana White",
"title": "VP Marketing",
"company_name": "Globex",
"linkedin_url": "https://www.linkedin.com/in/dana-white",
"email": "dana@globex.example"
}
]
}Get person profile
Sync profile enrichment (+ optional business email) for up to 25 people by LinkedIn URL, email, or a stored person_id; a person_id (or a URL/email that resolves to a stored person) writes the result back onto the CRM row.
List lead groups
List lead groups, optionally filtered by status.