Skip to main content
POST
Create a deal stage lookalike signal

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
crm
enum<string>
required

Your connected CRM. Must match the crm passed to List CRM deal stages.

Available options:
hubspot,
salesforce
name
string
required

Short label, unique in the account, e.g. 'Lookalikes of closed-won'.

Minimum string length: 1
watched_stages
string[] | null
required

Stage ids from List CRM deal stages, never labels typed by hand.

Minimum array length: 1
countries
string[] | null

Two-letter country codes the candidates must be in.

exclude_existing_crm_companies
boolean

Drop candidates you already have a deal on. Defaults to true; leave it on unless you want existing customers back.

industries
string[] | null

Industry names the candidates must be in.

is_enabled
boolean

Defaults to true.

max_employees
integer<int32>

Largest candidate headcount. Omit for no ceiling.

Required range: x >= 0
max_lookalikes_per_deal
integer<int32>

How many companies each won deal produces. Defaults to 25.

Required range: x >= 1
min_deal_amount
number<double>

Only deals worth at least this trigger the signal. Omit for every deal whatever its size.

Required range: x >= 0
min_employees
integer<int32>

Smallest candidate headcount. Omit for no floor.

Required range: x >= 0
min_score
integer<int32>

Lookalike score floor, 0 to 100. Defaults to 70. Raise it for fewer, closer matches.

Required range: 0 <= x <= 100
pipeline_ids
string[] | null

HubSpot only: restrict to these pipelines. Salesforce cannot filter on pipeline.

sizes
string[] | null

LinkedIn employee-size buckets the candidates must fall in: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.

Response

OK

id
string
required
is_enabled
boolean
required
kind
string
required

The kind, as List signals reports it and as a lead generation run takes it.

name
string
required
used_by_program_count
integer<int64>
required

Always 0 on creation: a signal runs only when a lead generation program picks it.