LinkedIn — Signals

Create a signal

Create a real-time intent watcher. We poll LinkedIn on the chosen cadence using the named session, classify each NEW post against the keyword, and (if a webhookUrl is set) POST high-intent matches to your endpoint with an HMAC-SHA256 signature. The lookback window is fixed at 24 hours — for historical lookups across a wider window use POST /v1/linkedin/searches instead.

post/linkedin/signals

Request

  • Base URL: https://anjal.app
  • URL: https://anjal.app/linkedin/signals
  • Auth: API key in header X-API-Key

Request body

namestring required
kind'keyword' | 'engagement' | 'job_change_watchlist'

keyword (default) — saved keyword search. engagement — watch a profile/company for engagers; requires target. job_change_watchlist — watch a list of profiles for role/company changes; requires watchlist.

querystring

Required when kind=keyword.

sessionIdstring nullable

Omit or send null to auto-distribute polling across every healthy LinkedIn session for this tenant (recommended — multiplies daily throughput by the number of connected accounts and protects each individual account from rate limits). Pass a specific session id to pin all polls for this signal to that account.

cadence'daily' | 'every_12h' | 'every_6h' | 'manual'
webhookUrlstring uri nullable
filterMinIntent'low' | 'medium' | 'high'
intentDescriptionstring required

Plain-English firing rule the LLM classifier treats as the authoritative definition of what should fire. Example: "Flag as ready when the author is a founder/ operator complaining about cold email — skip vendors, agencies, and content marketers."

Response

Created signal. webhookSecret is returned ONCE on creation when webhookUrl is set — store it now to verify webhook signatures.

Changes

No recorded changes to this operation across all 1 revision of this API.