POST
/
intents
/
accounts
/
growth
Create growth intent for accounts
curl --request POST \
  --url https://app.prontohq.com/api/v2/intents/accounts/growth \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
  "webhook_url": "https://prontohq.com/webhooks/growth",
  "min_headcount_growth_percentage": 10,
  "max_headcount_growth_percentage": 50,
  "department": "1",
  "min_department_headcount": 5,
  "max_department_headcount": 50,
  "min_department_headcount_growth_percentage": 20,
  "max_department_headcount_growth_percentage": 100,
  "company_size": [
    "1-10",
    "11-50"
  ],
  "included_locations": [
    "123"
  ],
  "excluded_locations": [
    "456"
  ],
  "included_industries": [
    "3812"
  ],
  "streaming": true
}'
{
  "message": "Account search started successfully. You will receive the results on your webhook shortly.",
  "id": "5d4fabd2-e26d-47d1-b0de-4bf370f7b799",
  "total": 150,
  "preview": [
    {
      "company_name": "Acme Inc",
      "industry": "Software Development",
      "linkedin_id": "123456",
      "linkedin_url": "https://www.linkedin.com/company/acme-inc"
    }
  ]
}
Find companies that are experiencing growth based on headcount or department growth metrics. This endpoint allows you to track companies that are expanding their workforce or specific departments.

​
Parameters

​
Headcount Growth

Track companies based on their overall headcount growth:
  • min_headcount_growth_percentage: Minimum percentage of headcount growth
  • max_headcount_growth_percentage: Maximum percentage of headcount growth

​
Department Growth

Track companies based on specific department growth:
  • department: Department ID to track growth for
  • min_department_headcount: Minimum department headcount
  • max_department_headcount: Maximum department headcount
  • min_department_headcount_growth_percentage: Minimum department headcount growth percentage
  • max_department_headcount_growth_percentage: Maximum department headcount growth percentage

​
Filters

Additional filters to narrow down the results:
  • company_size: Array of company size ranges to include
  • included_locations: Array of location IDs to include
  • excluded_locations: Array of location IDs to exclude
  • included_industries: Array of industry IDs to include

​
Webhook

  • webhook_url: URL to receive growth intent notifications
  • streaming: Whether to stream results as they come in

​
Response

The response includes:
  • A unique identifier for the growth intent
  • Total number of matching companies
  • Preview of the first 10 matching companies with their details
  • Success message

​
Example Response

{
  "message": "Account search started successfully. You will receive the results on your webhook shortly.",
  "id": "5d4fabd2-e26d-47d1-b0de-4bf370f7b799",
  "total": 150,
  "preview": [
    {
      "company_name": "Acme Inc",
      "industry": "Software Development",
      "linkedin_id": "123456",
      "linkedin_url": "https://www.linkedin.com/company/acme-inc"
    }
  ]
}

​
Notes

  • You must provide either headcount growth parameters or department growth parameters, but not both
  • When using department growth parameters, you must specify the department ID
  • Results will be delivered to your webhook URL as they become available
  • The preview shows the first 10 matching companies
  • Company size ranges follow LinkedIn’s standard size categories

​
Location IDs Reference

Location IDs used in this endpoint can be found in our reference spreadsheet. If you need additional locations added to this list, please contact our support team.

Authorizations

​
X-API-KEY
string
header
required

Your API key

Body

application/json

Response

201
application/json

Successfully created growth intent

The response is of type object.