The REST API: what it covers

The HuntSales REST API lets your own code use the same People Search and credits as the app. Create an API key under Admin, then Developer (your role needs the "API Keys & MCP" permission), and send it as a Bearer token, or in an X-API-Key header. The full reference, with request and response examples, is at /docs/api.

What it covers: searching people by job title, name, company, seniority, job function, country (country_list), city (city_list), industry, company size and a recent job change (up to 5 People Search credits per page of 50, at 0.1 per person shown, and a page fetched in the last 7 days is free); the app's other People Search filters, such as keywords, skills, past companies, schools and revenue, are refused with a 400 that names them, and nothing is charged; adding people from a search to your CRM with their work email looked up (2 credits per person added with an email, nothing without), checking on each email lookup, reading your credit balance, creating, listing and deleting your webhook endpoints and reading their recent deliveries, and reading and changing your companies, deals, tasks, contact notes and Suppression List (/api/v1/companies, /api/v1/deals, /api/v1/tasks, /api/v1/contacts/{id}/notes and /api/v1/suppression), each gated as its page in the app, the same as over MCP. Searching and adding need the People Search permission, managing webhook endpoints needs a Super Admin's key, and the credit balance is open to every member's key. A key can never do more than its owner's role allows. Each key may make 120 requests a minute to the REST API, and separately 120 a minute over MCP; past that the answer is 429, with a Retry-After header giving the seconds to wait. Webhooks follow the app: only a superadmin manages them, so only a Super Admin's key manages webhook endpoints over the API.

What it does not cover: there are no REST endpoints for contacts, lists, pipeline stages or campaigns (contact notes are covered). Those are available over MCP, which is how an AI assistant or your own code reads and changes them (see "Connect your own AI (MCP keys)" and /docs/mcp). Zapier and Make connect through signed webhooks (events out of HuntSales) and an automation's Incoming webhook trigger (events in; see the webhooks article) instead.