ToolsSearch & Enrichment
Add leads to group
Put leads the CRM already knows into a lead group by id - membership only, creates nothing.
Tool: add_leads_to_group
Use it to cherry-pick, subset, or merge groups. NOT for: external rows (CSV, scrape) → import_leads.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
lead_group_id | string (slug or UUID) | yes | Group to attach to. |
person_ids | array of strings | no | Person slugs from group rows or search results. |
company_ids | array of strings | no | Company slugs - pass either or both lists (at least one id total). |
Membership only - creates nothing and never mutates the lead records; unknown ids land in
attach.skipped_not_found.Use it to cherry-pick, subset, or merge groups; for external rows use
import_leads.
Sample request
{
"lead_group_id": "ceo-prospects-0010",
"person_ids": [
"dana-white-0015"
]
}