Skip to main content
POST
/
intents
/
leads
/
find_new_hires
Create new hires intent for accounts
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://prontohq.com/webhooks/new-hires",
  "included_job_titles": [
    "Product Manager",
    "Sales Director"
  ],
  "excluded_job_titles": [
    "Intern",
    "Contractor"
  ],
  "company_size": [
    "1-10",
    "11-50"
  ],
  "included_locations": [
    "123"
  ],
  "excluded_locations": [
    "456"
  ],
  "included_industries": [
    "3812"
  ],
  "excluded_industries": [
    "3813"
  ]
}'
{
  "message": "New hires tracking created successfully. Next run will be in 1 week."
}
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

Your API key

Body

application/json
​
webhook_url
string<uri>
required

URL to receive new hires notifications

Example:

"https://prontohq.com/webhooks/new-hires"

​
included_job_titles
string[]
required

Job titles to track

Example:
["Product Manager", "Sales Director"]
​
excluded_job_titles
string[]

Job titles to exclude from tracking

Example:
["Intern", "Contractor"]
​
company_size
enum<string>[]

Filter by company size ranges

Example:
["1-10", "11-50"]
​
included_locations
string[]

Location IDs to include

Example:
["123"]
​
excluded_locations
string[]

Location IDs to exclude

Example:
["456"]
​
included_industries
string[]

Industry IDs to include

Example:
["3812"]
​
excluded_industries
string[]

Industry IDs to exclude

Example:
["3813"]

Response

Successfully created new hires intent

​
message
string

Success message

Example:

"New hires tracking created successfully. Next run will be in 1 week."