Leads

Search, view, and import leads.

Tools (4)

search_leads

Full name: campaignstack_search_leads

leads:read Read-only Idempotent

Search leads in a workspace by name, company, or other criteria. Returns paginated results. Use returned leadId values with campaignstack_get_lead or campaignstack_add_leads_to_list.

Parameters

Name	Type	Required	Default	Description
workspaceId	string	Yes	—	(min length: 1)
query	string	No	—
companyId	string	No	—
limit	integer	No	20	(min: 1, max: 100)
cursor	string	No	—

---

get_lead

Full name: campaignstack_get_lead

leads:read Read-only Idempotent

Get a lead by ID with full details including company information and ICP scores. If the lead is not found, use campaignstack_search_leads to find valid lead IDs.

Parameters

Name	Type	Required	Default	Description
leadId	string	Yes	—	(min length: 1)

---

import_leads_csv

Full name: campaignstack_import_leads_csv

leads:write

Import leads from CSV data. Provide raw CSV content and optional column mapping. If no mapping is provided, columns are auto-mapped based on header names. After import, use campaignstack_search_leads to verify imported leads, or campaignstack_add_leads_to_list to add them to a campaign.

Parameters

Name	Type	Required	Default	Description
workspaceId	string	Yes	—	(min length: 1)
csvData	string	Yes	—	(min length: 1)
mapping	object	No	—

---

update_lead_metadata

Full name: campaignstack_update_lead_metadata

leads:write Idempotent

Update user-level metadata (notes and tags) on a lead. Only provided fields are updated. Use campaignstack_search_leads or campaignstack_get_lead to find lead IDs.

Parameters

Name	Type	Required	Default	Description
workspaceId	string	Yes	—	(min length: 1)
leadId	string	Yes	—	(min length: 1)
notes	string	No	—
tags	string[]	No	—

---