Lead Lists

Manage collections of leads within campaigns.

Tools (4)

list_lead_lists

Full name: campaignstack_list_lead_lists

lead_lists:read Read-only Idempotent

List all lead lists in a campaign with lead count per list. Use the returned leadListId values with campaignstack_get_lead_list or campaignstack_add_leads_to_list. Use campaignstack_list_campaigns to find valid campaign IDs.

Parameters

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

---

get_lead_list

Full name: campaignstack_get_lead_list

lead_lists:read Read-only Idempotent

Get a lead list by ID with details and optionally paginated leads. Set includeLeads to true to get the leads in the list. If the lead list is not found, use campaignstack_list_lead_lists to find valid IDs.

Parameters

Name	Type	Required	Default	Description
leadListId	string	Yes	—	(min length: 1)
includeLeads	boolean	No	false
limit	integer	No	20	(min: 1, max: 100)
cursor	string	No	—

---

create_lead_list

Full name: campaignstack_create_lead_list

lead_lists:write

Create a new lead list in a campaign. Optionally add leads by providing leadIds. Use campaignstack_list_campaigns to find valid campaign IDs and campaignstack_search_leads to find lead IDs.

Parameters

Name	Type	Required	Default	Description
campaignId	string	Yes	—	(min length: 1)
name	string	Yes	—	(min length: 1)
leadIds	string[]	No	—

---

add_leads_to_list

Full name: campaignstack_add_leads_to_list

lead_lists:write Idempotent

Add leads to an existing lead list. Idempotent — leads already in the list are skipped. Returns the count of newly added leads and already-present leads. Use campaignstack_list_lead_lists to find lead list IDs and campaignstack_search_leads to find lead IDs.

Parameters

Name	Type	Required	Default	Description
leadListId	string	Yes	—	(min length: 1)
leadIds	string[]	Yes	—

---