The three building blocks
1
Source agent: the lead finder
A source agent continuously sources leads matching your targeting criteria (job titles, industries, locations, signals, …) and scores them with AI.
2
List: where the leads land
Every source agent is linked to a list (
listId is required when creating an agent): the leads it finds are imported as contacts into that list. You can also fill a list yourself, by importing contacts or revealing leads from the Directory.3
Campaign: the outreach
A campaign uses one or more lists as its lead source (
listIds is required when creating a campaign). It runs its steps (LinkedIn invitations, messages, emails, …) on the contacts of those lists, sending through your LinkedIn and email seats. Once activated, it runs the outreach automatically every day.Terminology
Best practice: create a Full Cycle agent
Always create the three resources, in this order: first the list, then the source agent that fills it, then the campaign that reaches out to it. A source agent created without a campaign shows up as a legacy agent in the app and contacts nobody. A typical setup through the API, with the matching MCP tools:A new campaign starts active unless you pass
"active": false. Create it inactive if you want to review it before anything is sent..png?fit=max&auto=format&n=fLzJlZyi7L0nfF9B&q=85&s=7dc539f8ea9f771a09a9750c1227ebdb)
.png?fit=max&auto=format&n=fLzJlZyi7L0nfF9B&q=85&s=e742bcbb4bd47cd295da36c48cdd6089)