Find decision-makers at a company

Find the people at one company by title, seniority and function, through a shared Sales Navigator seat.

confirm false (the default) only previews: how many match and what it costs, no people. confirm true returns them and charges 0.02 credits a person.

company is a NAME. A company id passed there is searched as words; to search by id use search_people_sales_navigator with companyIds.

action is "preview", "blocked" or "results". leads, returned and creditsCharged are present only on "results". There is no next page.

Docs: https://heyreagent.com/docs/actions/find_decision_makers

post/v1/actions/find_decision_makers

Request

Base URL: https://api.heyreagent.com
URL: https://api.heyreagent.com/v1/actions/find_decision_makers
Auth: HTTP bearer

Request body

companystring required

Company name, e.g. "Stripe". Resolved to the LinkedIn company automatically.

titlesstring[]

Specific senior roles to target, e.g. ["VP of Sales","Head of Growth"]. Omit for the full decision-maker set (C-level/VP/Director/Founder).

senioritiesstring[]

Narrow by seniority level, e.g. ["CXO","VP","Director"] (owner/partner, cxo, vice_president, director, experienced_manager, entry_level_manager, strategic, senior, entry_level, in_training).

functionsstring[]

Narrow by job function/department, e.g. ["Sales","Marketing","Engineering"].

locationsstring[]

Optional person locations to narrow to, e.g. ["United States"].

limitnumber

Max people to return (1–100, default 15).

format'table' | 'csv'

table (default) = rows for a table. csv = also return an export-ready CSV string.

confirmboolean

false (default) = cost estimate only. true = pull and charge after the user agreed.

Response

It worked. Inside result: action, matchCount, estimatedCredits, creditsCharged, yourBalance, returned, leads.

oktrue required

resultobject required

What was asked for. A field that does not apply is left out, or is null.

Changes

No recorded changes to this operation across all 1 revision of this API.