Deploy Social Listening Signal

Deploy a Social Listening signal.

OpenFunnel Company Social Listening Agents listen for any announcements or conversations that a company is making across LinkedIn, Twitter, or Google.

Listen on things like:

• I want to target companies who raised seed funding
• I want to target companies posting about attending RSAC conference
• I want to target companies opening remote offices
• I want to target companies adding AI to their existing sta

Request Body:

• name (required): Name/identifier for this signal run
• search_query (required): LinkedIn search keyword (e.g. “AI tools”)
• signal_target (required): Whether to discover accounts or people (“account” or “people”, default: “account”)
• timeframe (required): Time limit in days (1-180)
• icp_id: ICP ID to use for filtering results against your Ideal Customer Profile
• repeat: Whether this signal should recur daily (default: false)
• account_audience_name: Audience name for auto-adding discovered accounts
• people_audience_name: Audience name for people enrichment
• max_credit_limit: Credit limit to enforce — signal stops once the limit is hit
• enable_safe_crm_addition: Auto-add discovered accounts to CRM. New/unassigned accounts are created and assigned to you; existing accounts get signals enriched. Ownership is never changed.

POST /api/v1/signal/deploy/social-listening-agent

Deploy Social Listening Signal

cURL

curl --request POST \
  --url https://api.openfunnel.dev/api/v1/signal/deploy/social-listening-agent \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --header 'X-User-ID: <x-user-id>' \
  --data '
{
  "name": "<string>",
  "search_query": "<string>",
  "timeframe": 90,
  "signal_target": "account",
  "icp_id": 123,
  "repeat": false,
  "account_audience_name": "<string>",
  "people_audience_name": "<string>",
  "max_credit_limit": 123,
  "enable_safe_crm_addition": false,
  "auto_enrich_people_emails": false
}
'

422

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Headers

X-API-Key · string · required

X-User-ID · string · required

Body

application/json

name · string · required

Name/identifier for this signal run

search_query · string · required

LinkedIn search keyword (e.g. 'AI tools')

timeframe · integer · required

Time limit in days (1-180)

Required range: 1 <= x <= 180

signal_target · enum<string> · default: account

Whether to discover accounts or people

Available options: account, people

icp_id · integer | null

ICP ID to use for filtering

repeat · boolean | null · default: false

Whether this signal should recur daily

account_audience_name · string | null

Audience name for auto-adding discovered accounts

people_audience_name · string | null

Audience name for people enrichment

max_credit_limit · integer | null

Credit limit to enforce on this signal. Signal will stop once max_credit_limit is hit

enable_safe_crm_addition · boolean | null · default: false

Auto-add discovered accounts to CRM. New/unassigned accounts are created and assigned to you; existing accounts get signals enriched. Ownership is never changed.

auto_enrich_people_emails · boolean | null · default: false

Automatically enrich discovered people with work emails. Requires people_audience_name to be set. Uses email enrichment credits.

Response

200

application/json

Successful Response