Create a source agent
Create a new source agent (the lead finder) for the authenticated user. A list is mandatory: the agent imports the leads it sources into a list, so you must create a list first (POST /v1/list) and link it to the agent through the required listId field. If the active agent limit is reached, the agent is still created but paused. A source agent only finds leads — it does no outreach. Without a campaign agent attached to the same list, it shows up as a legacy agent in the platform. Best practice is to follow up with POST /v1/campaign using the same list as lead source, forming a Full Cycle agent (list + source agent + campaign agent) that sources and reaches out to leads automatically.
Signals (variables): the agent finds leads through its signals. variables is optional, but when sent it must hold 4 to 15 signals, and an “autopilot” agent created without it is accepted but has nothing to run. Each signal is a { "type", "value" } object, and the value format depends on the type: a quoted keyword of 1 to 3 words for SEARCH_KEYWORD ("\"cold email\""), a LinkedIn company page URL for COMPETITOR_PAGE_URL (https://www.linkedin.com/company/lemlist), a LinkedIn profile URL for INFLUENCER_PAGE_URL (https://www.linkedin.com/in/johndoe), the literal "true" for event signals (RECENTLY_CHANGED_JOB, HIRING, …), and a lowercase technology name for TECHNOLOGY (hubspot). VISITED_PROFILE and YOUR_COMPANY_FOLLOWERS also need needsUserToken: true and a linkedinSeatId. The API does not validate values: a malformed keyword, URL, or technology is saved anyway, and that signal then finds no leads or the wrong ones. The value field of the variable schema lists the exact format for every type.
Authorizations
API key from Settings → API. Send it as Authorization: Bearer .
Headers
ID of an organization member to act on behalf of. The API key user must be the owner of the organization and the target user must belong to the same organization.
Body
Name of the source agent
"SaaS CTOs - Europe"
ID of the list the agent imports its sourced leads into. A list is mandatory: create one first (POST /v1/list) and pass its ID here. The list must belong to the authenticated user.
123
Target job titles to search for
Target industries to search in
Target company sizes
2-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+ Target locations to search in
Target company types
All company types, Private Company, Public Company, Startup, Non-profit, Government, Educational Institution, Other Type of agent: "autopilot" (default), "lookalike" or "website-visitor".
autopilot, lookalike, website-visitor The signals the agent tracks to find leads. Each variable is one signal: one keyword, one LinkedIn URL, one event, or one technology. Send between 4 and 15 variables. An "autopilot" agent created without variables has no signal to run. Optional for "website-visitor" agents (the website visitor signal is added automatically) and not allowed for "lookalike" agents. Each variable needs a type and a value whose format depends on the type. See value for every type: quoted keyword, LinkedIn page URL, "true" for event signals, or lowercase technology name. Values are not validated: a malformed keyword, URL, or technology is saved anyway, and that signal then finds no leads or the wrong ones. LOOKALIKE variables are refused, and JOB_SEARCH variables are refused for now.
Companies to ignore in search results
Keywords that must be present in the profile
Exclude service providers from results
Skip ICP (Ideal Customer Profile) filter
Include open-to-work profiles in results
Enable smart lead finder mode, usually true
Create the agent paused. Note: the agent is also created paused when the active agent limit is reached.
Minimum lead score threshold (0–1) - Usually 0.6 or 0.8
Max number of credits per month (website visitor agent only)
Response
Agent created
Unique identifier
Display name of the agent
List of target job titles to prospect. Part of the ICP.
List of target industries to prospect. Part of the ICP.
List of target company sizes (e.g. "1-10", "11-50"). Part of the ICP.
List of target geographic locations. Part of the ICP.
List of target company types (e.g. "Public", "Private")
Type of agent: "autopilot", "lookalike" or "website-visitor"
"autopilot"
Whether the visitor tracking script is installed on the website (website-visitor agents)
Credits consumed so far in the current period (e.g. website-visitor company identifications)
Whether the agent is paused and will not run on its next scheduled time
Whether to exclude service provider companies from prospecting
Whether to skip the ICP (Ideal Customer Profile) filter when sourcing leads
Whether to include LinkedIn profiles marked as open to work
Whether to use the lead waterfall strategy (cascade through multiple sources)
ID of the account (user) who owns this agent
Creation timestamp
Last update timestamp
Additional free-text targeting criteria
Variables used by the agent to find high intent leads. (Keywords, Competitor Page URL, etc.)
Company names to exclude from prospecting. Part of the ICP.
Keywords that must be present in a lead profile to be included
Snitcher tracking script ID, used as the profileId in the tracking snippet (website-visitor agents)
Max number of credits per month
200
Timestamp of the last agent execution
Minimum lead score threshold (0.00–1.00) required to include a lead
0.75
ID of the list this agent sources contacts into
.png?fit=max&auto=format&n=fLzJlZyi7L0nfF9B&q=85&s=7dc539f8ea9f771a09a9750c1227ebdb)
.png?fit=max&auto=format&n=fLzJlZyi7L0nfF9B&q=85&s=e742bcbb4bd47cd295da36c48cdd6089)