POST
/
intents
/
accounts
/
hiring
curl --request POST \
  --url https://app.prontohq.com/api/v2/intents/accounts/hiring \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
  "webhook_url": "https://prontohq.com/webhooks/hiring",
  "selected_keywords": [
    "Airtable",
    "Notion",
    "Monday"
  ],
  "excluded_keywords": [
    "Excel",
    "Google Sheets"
  ],
  "selected_titles": [
    "Product Manager",
    "Project Manager"
  ],
  "excluded_titles": [
    "Contractor"
  ],
  "job_min_posted": 1,
  "exclude_consulting_recruiting": true,
  "exclude_internships": true,
  "published_date": "last_24_hours",
  "company_size": [
    "1-10",
    "11-50"
  ]
}'
{
  "preview_count": 13,
  "message": null,
  "id": "5d4fabd2-e26d-47d1-b0de-4bf370f7b799"
}

Authorizations

​
X-API-KEY
string
header
required

Your API key

Body

application/json
​
webhook_url
string
required

URL to receive hiring intent notifications

Example:

"https://prontohq.com/webhooks/hiring"

​
selected_keywords
string[]

Keywords to include in job search

Example:
["Airtable", "Notion", "Monday"]
​
excluded_keywords
string[]

Keywords to exclude from job search

Example:
["Excel", "Google Sheets"]
​
selected_titles
string[]

Job titles to include

Example:
["Product Manager", "Project Manager"]
​
excluded_titles
string[]

Job titles to exclude

Example:
["Contractor"]
​
job_min_posted
integer
default:1

Minimum number of job postings (defaults to 1)

Example:

1

​
exclude_consulting_recruiting
boolean

Exclude consulting and recruiting companies

Example:

true

​
exclude_internships
boolean

Exclude internship positions

Example:

true

​
published_date
enum<string>

Time range for job postings

Available options:
last_24_hours,
last_7_days,
last_15_days,
last_30_days,
last_90_days,
last_180_days,
last_360_days
Example:

"last_24_hours"

​
company_size
enum<string>[]

Filter by company size ranges

Available options:
Self-employed,
1-10,
11-50,
51-200,
201-500,
501-1000,
1001-5000,
5001-10000,
10001+
Example:
["1-10", "11-50"]

Response

201
application/json
Successfully created hiring intent
​
preview_count
integer

Number of matching job postings

Example:

13

​
message
string | null

Optional message

Example:

null

​
id
string

Unique identifier for the hiring intent

Example:

"5d4fabd2-e26d-47d1-b0de-4bf370f7b799"