Save search
Commit all pending or explicitly selected staged results.
Tool: save_search
The first save creates exactly one compatible lead group unless lead_group_id is supplied; later saves from the same search reuse that destination. Rejected or unselected rows remain staged and no canonical entity is created for them. The response returns added_member_ids so a sequence refill can enroll only the people added by this save.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
search_id | string | yes | The durable staged search to commit. |
group_name | string | no | Create and bind a new typed lead group on first save. |
lead_group_id | string | no | Bind to one compatible existing group on first save. |
result_ids | string[] | no | Save exactly these staged result IDs; omit to save all pending rows. |
The first save requires exactly one destination: group_name or lead_group_id.
Later saves reuse the bound destination and are idempotent.
Sample request — people
{
"search_id": "src_bZjyFykPsXzY3sSP",
"group_name": "CEO prospects"
}Sample request — companies
{
"search_id": "src_zBsTgJMi1k7aIMQJ",
"group_name": "Software companies"
}Sample request — import
{
"search_id": "src__t6EJjtSfQz4Q2Wh",
"group_name": "Imported from CSV"
}Resolve industry
Turn a natural industry/market phrase ('AI companies', 'data annotation', 'sports software') into exact validated filter values: ranked plans, each with a LinkedIn industry base plus (tech segments only) precise Crunchbase category tags, ready to paste into search_companies.
Search companies
Stage companies by industry, size, funding, or geo.