Skip to main content
POST
/
intents
/
leads
/
find_new_hires
Find new hires
curl --request POST \
  --url https://app.prontohq.com/api/v2/intents/leads/find_new_hires \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "webhook_url": "https://your-company.com/webhooks/new_hires",
  "persona_id": "persona_abc123",
  "headcount": [
    "C",
    "D",
    "E"
  ],
  "industries": [
    "Software Development"
  ],
  "location_ids": [
    103644278
  ],
  "domain_allow_list": [
    "acme.com"
  ],
  "domain_deny_list": [
    "competitor.com"
  ]
}
'
{
  "id": "abc123",
  "status": "pending"
}

Documentation Index

Fetch the complete documentation index at: https://docs.prontohq.com/llms.txt

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

Track when companies make new hires matching specific ICP. This endpoint creates a weekly tracking task that will notify you through a webhook when matching new hires are found.

​
Use Cases

  • Monitor when competitors hire for specific roles
  • Track hiring trends in your target market
  • Identify companies expanding specific departments
  • Get notified about potential customer expansion signals

​
Location IDs Reference

Location IDs used in this endpoint can be retrieved using the Location Ids endpoint. Simply provide a location name (e.g., “San Francisco”) and the API will return all matching locations with their IDs.

Authorizations

​
X-API-KEY
string
header
required

Body

application/json
​
webhook_url
string<uri>
required

URL to receive new hire notifications

Example:

"https://your-company.com/webhooks/new_hires"

​
persona_id
string

Persona ID to target specific roles

Example:

"persona_abc123"

​
headcount
enum<string>[]

Company headcount range filters

Available options:
A,
B,
C,
D,
E,
F,
G,
H,
I
Example:
["C", "D", "E"]
​
industries
string[]

Industry filters

Example:
["Software Development"]
​
location_ids
integer[]

Location IDs to filter by

Example:
[103644278]
​
domain_allow_list
string[]

Only include companies from these domains

Example:
["acme.com"]
​
domain_deny_list
string[]

Exclude companies from these domains

Example:
["competitor.com"]

Response

New hire search results

​
id
string

Unique identifier for the search

Example:

"abc123"

​
status
string

Status of the search

Example:

"pending"