Enrichment Status

Track the progress of lead enrichment batches.

Tools (4)

get_enrichment_status

Full name: campaignstack_get_enrichment_status

leads:read Read-only Idempotent

Get the current enrichment queue status for a workspace. Shows counts of pending, processing, completed, and failed items, plus creditsExhausted (pending items deferred because the workspace is out of credits) and accountGates: the live dispatch verdict per account with pending work (allowed, immediateOnly, and the block reason such as outside_business_hours or budget_exhausted). Call this when the user asks how enrichment is progressing, or why queued leads have not shown up yet. Use accountGates to explain why pending items are not moving. Optionally filter by campaign.

Parameters

Name	Type	Required	Default	Description
workspaceId	string	Yes	—	Workspace ID. REQUIRED for a user key (csu_), which spans every workspace you belong to; omitted for a workspace key (cs_), which is bound to one and ignores this argument. campaignstack_whoami reports which kind of key you are holding and, for a user key, the workspaces it can reach. (min length: 1)
campaignId	string	No	—
platform	string	No	—

---

queue_leads

Full name: campaignstack_queue_leads

leads:write

Add LinkedIn profiles read off a search results page to the enrichment pipeline at normal priority. Call this when a search step just returned a page of partial LinkedIn profiles to enrich. Each result is validated and deduped by profile slug; invalid URLs are skipped rather than failing the batch. It does not jump the queue: campaignstack_priority_enrich does that for slugs you already have. platform defaults to ‘linkedin’.

Parameters

Name	Type	Required	Default	Description
workspaceId	string	Yes	—	Workspace ID. REQUIRED for a user key (csu_), which spans every workspace you belong to; omitted for a workspace key (cs_), which is bound to one and ignores this argument. campaignstack_whoami reports which kind of key you are holding and, for a user key, the workspaces it can reach. (min length: 1)
campaignId	string	Yes	—	(min length: 1)
accountId	string	Yes	—	(min length: 1)
platform	string	No	—
results	object[]	Yes	—

---

priority_enrich

Full name: campaignstack_priority_enrich

leads:write

Enrich up to 50 specific LinkedIn profile slugs immediately, ahead of the normal queue. Call this when you already have exact slugs and need them ready now, for example before scoring or drafting a small set of leads. For a page of search results with only partial data, use campaignstack_queue_leads instead. Use campaignstack_get_enrichment_status to monitor progress.

Parameters

Name	Type	Required	Default	Description
workspaceId	string	Yes	—	Workspace ID. REQUIRED for a user key (csu_), which spans every workspace you belong to; omitted for a workspace key (cs_), which is bound to one and ignores this argument. campaignstack_whoami reports which kind of key you are holding and, for a user key, the workspaces it can reach. (min length: 1)
accountId	string	Yes	—	(min length: 1)
slugs	string[]	Yes	—
platform	string	No	—

---

build_search_url

Full name: campaignstack_build_search_url

leads:read Read-only Idempotent

Build a LinkedIn People search URL from ICP (Ideal Customer Profile) criteria: titles, industries, locations, seniorities, company sizes, and keywords. Call this when the user wants a LinkedIn search link built from an ICP’s criteria, for example to open themselves or hand to a browsing step. It does not run the search or return any leads itself: pass whatever it finds through campaignstack_queue_leads to bring results in. Use campaignstack_list_icps to get ICP criteria for a campaign, then pass them here.

Parameters

Name	Type	Required	Default	Description
titles	string[]	No	—
industries	string[]	No	—
locations	object[]	No	—
seniorities	string[]	No	—
companySizes	string[]	No	—
keywords	string[]	No	—

---