Skip to main content
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://your-company.com/webhooks/growth",
  "streaming": false,
  "limit": 500,
  "min_headcount_growth_percentage": 10,
  "max_headcount_growth_percentage": 50,
  "department": "1",
  "min_department_headcount": 5,
  "max_department_headcount": 100,
  "min_department_headcount_growth_percentage": 15,
  "max_department_headcount_growth_percentage": 80,
  "company_size": [
    "51-200",
    "201-500"
  ],
  "included_locations": [
    103644278
  ],
  "excluded_locations": [],
  "included_industries": [
    "4"
  ]
}
'
{
  "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/123456"
    }
  ],
  "account_url": "<string>"
}
Find companies that are experiencing growth using company-wide headcount growth or department-level metrics. The search runs against LinkedIn account data; matching companies are imported and sent to your webhook. Send parameters inside a top-level JSON object under the key account. Only documented fields are allowed; extra keys under account are rejected with a validation error.

​
Growth criteria (pick one approach)

1. Company-wide headcount growth Provide at least one of:
  • min_headcount_growth_percentage
  • max_headcount_growth_percentage
Do not send department in this mode. Company-wide headcount growth and department filters cannot be used together. 2. Department-level metrics Always send department (a string ID for the LinkedIn function to target, for example "1"). Also include at least one of:
  • min_department_headcount and/or max_department_headcount, or
  • min_department_headcount_growth_percentage and/or max_department_headcount_growth_percentage
department alone is not enough. Department headcount or department growth fields without department are not allowed.

​
Other fields (inside account)

  • webhook_url (required): URL that receives results when processing completes.
  • streaming (optional): Whether to stream results as they are processed.
  • limit (optional): Maximum number of companies to import. If omitted, the import is still capped at 1000 companies even when the search finds more; the total field in the response reflects the full match count from the search when no limit is set.

​
Filters

  • company_size: Array of company size range strings (LinkedIn-style buckets). En-dash characters in values are normalized to hyphens on the server.
  • included_locations: Array of location IDs to include.
  • excluded_locations: Array of location IDs to exclude.
  • included_industries: Array of industry IDs to include.
Allowed company_size values:
  • 1-10
  • 11-50
  • 51-200
  • 201-500
  • 501-1000
  • 1001-5000
  • 5001-10000
  • 10001+
For the complete list of industry IDs, see the LinkedIn Industry List. Common industry IDs include:
  • 4 - Automotive
  • 6 - Technology, Information and Internet
  • 12 - Education
  • 43 - Financial Services
  • 96 - Software Development

​
Department validation

department must be a string and must be one of the allowed LinkedIn function IDs used by the API.

​
Response

Successful requests return 201 Created with:
  • message: Confirmation that the account search started and results will be sent to the webhook.
  • id: UUID of the import job.
  • total: If limit is set, this is the smaller of the search size and limit. If limit is omitted, this is the full search size (import volume may still be capped at 1000 as above).
  • preview: Up to 10 sample companies, each with company_name, industry, linkedin_id (numeric ID from the result), and linkedin_url in the form https://www.linkedin.com/company/{linkedin_id}.
In development environments, responses may also include account_url for debugging.

​
Example request

{
    "webhook_url": "https://your-company.com/webhooks/growth",
    "min_headcount_growth_percentage": 10,
    "company_size": ["51-200"],
    "included_locations": [103644278],
    "streaming": false
}

​
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/123456"
    }
  ]
}

​
Errors

  • 401: Not enough credits to create a list for the number of companies returned by the search (Insufficient credits), or Sales Navigator requirements are not met.
  • 422: Invalid combinations of growth parameters, disallowed extra parameters, invalid department type or value, or invalid optional filters (company size, locations, industries).

​
Location IDs reference

Resolve IDs for included_locations and excluded_locations using the Location Ids endpoint.

Authorizations

​
X-API-KEY
string
header
required

Body

application/json
​
webhook_url
string<uri>
required

URL to receive growth intent results when processing completes

Example:

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

​
streaming
boolean

Whether to stream results to the webhook as they are processed

Example:

false

​
limit
integer

Maximum number of companies to import. If omitted, import volume is capped at 1000 even when the search finds more; response total reflects the effective count

Required range: x >= 1
Example:

500

​
min_headcount_growth_percentage
number

Minimum company-wide headcount growth percentage (use with or without max_headcount_growth_percentage; not valid together with department)

Example:

10

​
max_headcount_growth_percentage
number

Maximum company-wide headcount growth percentage (use with or without min_headcount_growth_percentage; not valid together with department)

Example:

50

​
department
string

LinkedIn function ID to target (string, e.g. "1"). Required when using any department headcount or department growth field; must not be set together with company-wide headcount growth fields

Example:

"1"

​
min_department_headcount
integer

Minimum headcount in the selected department (requires department)

Example:

5

​
max_department_headcount
integer

Maximum headcount in the selected department (requires department)

Example:

100

​
min_department_headcount_growth_percentage
number

Minimum department headcount growth percentage (requires department)

Example:

15

​
max_department_headcount_growth_percentage
number

Maximum department headcount growth percentage (requires department)

Example:

80

​
company_size
string[]

LinkedIn-style company size range strings (e.g. 51-200). Unicode en-dashes in values are normalized to hyphens on the server

Example:
["51-200", "201-500"]
​
included_locations
integer[]

Location IDs to include

Example:
[103644278]
​
excluded_locations
integer[]

Location IDs to exclude

Example:
[]
​
included_industries
string[]

Industry IDs to include

Example:
["4"]

Response

Search started; results are delivered to the webhook

​
message
string
required

Confirmation that the account search started

Example:

"Account search started successfully. You will receive the results on your webhook shortly."

​
id
string<uuid>
required

UUID of the import job

Example:

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

​
total
integer
required

Number of companies for this run: if limit is set, the lesser of search size and limit; otherwise the full search size (import may still cap at 1000)

Example:

150

​
preview
object[]
required

Up to 10 sample companies from the search

Maximum array length: 10
​
account_url
string<uri>

Present only in development environments (debugging)