Skip to main content
POST
Start a lead generation run

Authorizations

Authorization
string
header
required

Account API key passed in the Authorization header

Query Parameters

account_id
string

Target account UUID. Required for staff callers; ignored for customer API keys.

Body

application/json
signals
object[] | null
required

One to twenty signals to sweep, from List signals. Every kind with a sweep of its own can be picked.

Required array length: 1 - 20 elements
target_leads
integer<int64>
required

How many leads you want in the list.

Required range: 1 <= x <= 2000
name
string

Optional name for the program, which also names the list its runs fill. Omit for a timestamped default.

Maximum string length: 120
qa_enabled
boolean

Have an AI judge each lead against your ICP and personas and drop the failures. Defaults to true.

Response

OK

name
string
required
program_id
string
required

The program recorded for this run, with no schedule. Open it under Settings > Signals > Lead generation to put it on one.

qa_enabled
boolean
required
run_id
string
required
signals
integer<int64>
required

How many signals the run sweeps.

target_leads
integer<int32>
required