Skip to main content
POST
Create a page follower 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
linkedin_company_url
string
required

The page to watch: a linkedin.com /company/, /school/ or /showcase/ URL. Anyone's page, not only your own.

Minimum string length: 1
name
string
required

Short label, unique in the account. Name it after the page, e.g. 'Acme page followers'.

Minimum string length: 1
countries
string[] | null

Provider-side country filter, country NAMES from List page follower filter values. Applied during the scrape, so it lowers what each sweep costs.

departments
string[] | null

Provider-side department filter, from List page follower filter values. Applied during the scrape.

is_enabled
boolean

Defaults to true.

job_titles
string[] | null

Provider-side job-title filter, from List page follower filter values. Applied during the scrape.

max_followers_per_sweep
integer<int32>

Followers read per sweep. Defaults to 250. The cost dial: reading a follower is paid.

Required range: 1 <= x <= 1000
seniority_levels
string[] | null

Provider-side seniority filter, from List page follower filter values. Applied during the scrape.

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.