Deploy Deep Company Search Signal

Deploy a Deep Company Search signal.

Describe the companies you want to find with:

• Trait (trait, required) - What the company does: industry they sell to, or kinds of products and services they sell
• Activity (activity, optional) - What the company is actively investing in:
  • A direct hiring signal
  • Repeated intent across job posts
  • A hiring-plus-got-hired pattern

Example patterns

Trait only

• trait: Health-tech companies selling transcription software

Direct hiring signal

• activity: Hiring ML engineers
• trait: Health-tech companies

Repeated intent across job posts

• activity: Mentioning AI risk or model governance in more than 3 job posts in last 90 days
• trait: Fintech companies operating in regulated industries

Hiring + got hired

• activity: Hiring outbound sales roles and got hired in last 90 days
• trait: B2B SaaS companies

First hire flow

• activity: First security hire in last 90 days
• trait: Developer tools companies

POST /api/v1/signal/deploy/deep-company-search-agent

Deploy Deep Company Search Signal

cURL

curl --request POST \
  --url https://api.openfunnel.dev/api/v1/signal/deploy/deep-company-search-agent \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --header 'X-User-ID: <x-user-id>' \
  --data '
{
  "name": "<string>",
  "trait": "<string>",
  "activity": "<string>",
  "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,
  "advanced_people_finder": false
}
'

200

{
  "signal_id": 123,
  "status": "<string>"
}

Headers

X-API-Key · string · required

X-User-ID · string · required

Body

application/json

name · string · required

Name/identifier for this signal run

trait · string · required

Company trait - describe what the company does, such as the industry it sells to or the kinds of products and services it sells.

activity · string | null

Company activity - what the companies are doing. Supports direct hiring/activity signals (e.g. 'Hiring ML engineers'), repeated intent across job posts (e.g. 'Mentioning AI risk in more than 3 job posts in last 90 days'), and hiring-plus-hire-window patterns (e.g. 'Hiring outbound sales roles and got hired in last 90 days').

icp_id · integer | null

ICP ID to use for filtering

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 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. Uses email enrichment credits.

advanced_people_finder · boolean | null · default: false

Enable advanced LLM-based people finder in addition to fast enrichment. Consumes OpenFunnel credits

Response

200

application/json

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').