Skip to main content
POST
/
api
/
v2
/
signal
/
deploy
/
linkedin-engagement
Find ICP companies + people interacting with any LinkedIn profile
curl --request POST \
  --url https://api.openfunnel.dev/api/v2/signal/deploy/linkedin-engagement \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "name": "<string>",
  "linkedin_url": "<string>",
  "icp_id": 123,
  "descriptive_icp": "<string>",
  "timeframe": 7,
  "repeat": false,
  "account_audience_name": "<string>",
  "people_audience_name": "<string>",
  "max_credit_limit": 123,
  "enable_safe_crm_addition": false,
  "auto_enrich_people_emails": false,
  "advanced_people_finder": false
}
'
{
  "signal_id": 123,
  "status": "<string>"
}

Headers

​
X-API-Key
string
required

Body

application/json

Sentence: ICP people interacting with [linkedin_url]

Find and qualify ICP people who like or comment on posts by a specific LinkedIn profile.

​
name
string
required

Name/identifier for this signal run

​
linkedin_url
string
required

LinkedIn profile URL to monitor for engagement (e.g. 'https://linkedin.com/in/founder-name').

​
icp_id
integer
required

ICP ID for company filtering (required)

​
descriptive_icp
string | null

Helps you specify a Company Category to target. It can be any company description in natural language (a category, industry, or business model), but never firmographic filters like employee count, location, or funding, which belong only in your ICP (icp_id). The items below are just examples of possible descriptive ICPs. Examples: B2B SaaS Companies, B2B Fintech Companies, Neobanking Companies, B2B Customer Support SaaS Companies, Health-tech SaaS companies that sell to dentists, or Companies that offer Developer Observability Solutions. Optional - when omitted, searches across all industries.

​
timeframe
integer | null
default:7

Lookback window in days (default: 7, max: 180)

​
repeat
boolean | null
default:false

Run this signal daily to discover new results (default: false, runs once)

​
account_audience_name
string | null

Audience name for auto-adding discovered accounts (default: ' - Accounts')

​
people_audience_name
string | null

Audience name for people enrichment (default: ' - People')

​
max_credit_limit
integer | null

Credit limit for this signal. Signal stops once this many credits are consumed.

​
enable_safe_crm_addition
boolean | null
default:false

Auto-add discovered accounts to CRM in safe mode. New accounts are created; existing accounts are enriched without ownership changes.

​
auto_enrich_people_emails
boolean | null
default:false

Enrich discovered people with work emails. Requires enable_safe_crm_addition to be true.

​
advanced_people_finder
boolean | null
default:false

Enable advanced LLM-based people finder for deeper people discovery.

Response

Successful Response

Common response shape for signal deployment endpoints. Returns at minimum the signal_id and a status. Some agents return additional fields (e.g. message, campaign_id) which are not documented in this shape.

​
signal_id
integer
required

ID of the deployed signal. Use this to poll signal status or fetch results.

​
status
string
required

Deployment status (e.g. 'accepted', 'running').