Skip to main content
POST
/
api
/
v2
/
signal
/
deploy
/
linkedin-activity
Monitor a profile's outreach to ICP people
curl --request POST \
  --url https://api.openfunnel.dev/api/v2/signal/deploy/linkedin-activity \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --header 'X-User-ID: <x-user-id>' \
  --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>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.openfunnel.dev/llms.txt

Use this file to discover all available pages before exploring further.

Headers

X-API-Key
string
required
X-User-ID
string
required

Body

application/json

Sentence: [linkedin_url] interactions with ICP people

Monitor a competitor or salesperson's LinkedIn activity to discover accounts and people they're targeting.

name
string
required

Name/identifier for this signal run

linkedin_url
string
required

LinkedIn profile URL of the person to monitor (e.g. a competitor salesperson's profile).

icp_id
integer
required

ICP ID for company filtering (required)

descriptive_icp
string | null

Company type or industry to narrow results (e.g. 'B2B fintech', 'B2B SaaS', 'DevTools'). 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').