Skip to main content
POST
/
api
/
v1
/
signal
/
deploy
/
deep-company-search-agent
Deploy Deep Company Search Signal
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>",
  "qualifier": "<string>",
  "query_mode": "standard",
  "buying_window_type": "<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
}
'
{
  "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
​
name
string
required

Name/identifier for this signal run

​
trait
string
required

Company trait — describe the type of companies you're looking for (e.g. 'Health-tech companies', 'Fintech startups', 'Insurance companies'). This defines industry, company stage, or characteristics.

​
activity
string | null

Company activity — what the companies are doing (e.g. 'Building AI-powered analytics tools', 'Using Salesforce', 'Hiring ML engineers'). Filters by hiring patterns, tech adoption, or other activities.

​
qualifier
string | null

Organization qualifier — team structure or headcount criteria (e.g. 'Has a VP of Engineering', 'Has a dedicated Customer Success team of 10+', 'Has a DevOps team'). Uses LLM-driven qualification on company people data.

​
query_mode
enum<string> | null
default:standard

Optional GTM Wiki query mode. Use 'buying_window' for people buying-window flows.

Available options:
standard,
buying_window
​
buying_window_type
string | null

Optional buying window type when query_mode='buying_window'. Currently supports 'specific_hire'.

​
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

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