Hunter

Remove campaign recipients.

Delete a saved company.

Remove a tag from a saved company.

Delete a company list.

Remove a company from a company list.

Unfavorite a company list.

Delete a company list folder.

Delete a company tag.

Delete a saved discover view.

Delete a lead.

Remove a tag from a lead.

Delete a lead custom attribute.

Delete a lead list.

Unfavorite a lead list.

Delete a lead list folder.

Delete a message template.

Delete a sequence.

Delete a sequence follow-up step.

Remove sequence recipients.

Resume a paused sequence.

Delete a lead tag.

Delete webhooks by identifier (legacy).

Delete a webhook.

Get account details and usage.

Get account profile summary.

List campaigns.

Get a campaign follow-up step.

List campaign recipients.

Enrich a person and company. Spends the account's monthly search or credit allowance; a Free plan has 50 searches, 50 credits and 100 verifications a month.

List saved companies.

Get a saved company.

Enrich a company. Spends the account's monthly search or credit allowance; a Free plan has 50 searches, 50 credits and 100 verifications a month.

List company lists.

Get a company list.

List company list folders.

Get a company list folder.

List company tags.

Get a company tag.

List connected apps.

Get a connected app.

Discover people matching filters. Spends the account's monthly search or credit allowance; a Free plan has 50 searches, 50 credits and 100 verifications a month.

List saved discover views.

Get a saved discover view.

Count domains matching discovery filters. Hunter serves this operation without a credential (the contract gives it an empty security requirement), so it answers even for an account whose key is wrong; never treat a success here as proof that the connection works.

Find the domain for a company.

Find email addresses by domain. Spends the account's monthly search or credit allowance; a Free plan has 50 searches, 50 credits and 100 verifications a month.

Suggest domains for a company name.

List email accounts.

The account's `signature` is returned HTML-sanitized (HUN-22571).

Get an email account health report.

List sequences using an email account.

Get an email account usage report.

Get an email account warmup report.

Get email account sending capacities.

Return aggregate counts without revealing individual email addresses. This operation is free.

Supply a LinkedIn handle, or supply a domain/company plus either a full name or first and last name. A found email address is also saved automatically to your leads. This is enabled by default and can be disabled for your account. Spends the account's monthly search or credit allowance; a Free plan has 50 searches, 50 credits and 100 verifications a month.

Found-only variant of email finder. Supply a LinkedIn handle, or supply a domain/company plus either a full name or first and last name. Spends the account's monthly search or credit allowance; a Free plan has 50 searches, 50 credits and 100 verifications a month.

Get deliverability insight for an email address. Hunter serves this operation without a credential (the contract gives it an empty security requirement), so it answers even for an account whose key is wrong; never treat a success here as proof that the connection works.

Check the deliverability of an email address. A verified email address is also saved automatically to your leads. This is enabled by default and can be disabled for your account. Spends the account's monthly search or credit allowance; a Free plan has 50 searches, 50 credits and 100 verifications a month.

Each lead carries `department` since HUN-23171. It was already a filter on this endpoint, but was never emitted, so a caller could filter on a field it could not read back.

Check whether leads exist in bulk.

Returns `department` since HUN-23171. It was filterable on the collection endpoint and settable by enrichment before that, but never emitted, so a caller could filter on a field it could not read back.

List lead custom attributes.

Get a lead custom attribute.

Check whether a lead exists.

List lead lists.

Get a lead list.

List lead list folders.

Get a lead list folder.

Finds companies that look like the ones in one of your company lists. The companies in the list are used as a seed, and we return the most similar companies ranked by a similarity score. This endpoint is not paginated: it returns a single ranked page of the top limit results, so the offset parameter is not supported and returns 400 if supplied. This call is free.

List message templates.

Get a message template.

List messages.

Enrich a person. Spends the account's monthly search or credit allowance; a Free plan has 50 searches, 50 credits and 100 verifications a month.

List sequences.

Get a sequence.

List sequence follow-up steps.

Get a sequence follow-up step.

List sequence recipients.

Get sequence performance stats.

List lead tags.

Get a lead tag.

List team members.

Get credit usage summary.

Get credit usage history.

List webhooks.

Get a webhook.

Update a company list.

Update a company list folder.

Update a company tag.

Update an email account.

Accepts `department` since HUN-23171. The value is normalized to its canonical key, so a localized display label ("Sales") is stored as `sales`. Lead attributes are not modelled field-by-field in this contract yet — the response uses the generic resource envelope — so this note is where the accepted set is recorded.

Update a lead custom attribute.

Update a lead list.

Update a lead list folder.

Update a message template.

Update a sequence.

Update a sequence follow-up step.

Update a lead tag.

Update a webhook.

Add a campaign follow-up step.

Add campaign recipients.

Start a campaign. SENDS REAL EMAIL from a connected email account to the addresses named. There is no draft or preview step.

Save a company.

Copy companies to another list in bulk.

Delete companies in bulk.

Move companies to another list in bulk.

Tag companies in bulk.

Tag a saved company.

Create a company list.

Add a company to a company list.

Favorite a company list.

Create a company list folder.

Create a company tag.

Push data to a connected app.

Find companies matching a structured filter set. This operation is free. Spends the account's monthly search or credit allowance; a Free plan has 50 searches, 50 credits and 100 verifications a month.

Discover people using request-body filters. Spends the account's monthly search or credit allowance; a Free plan has 50 searches, 50 credits and 100 verifications a month.

Create a saved discover view.

Find the domain for a company via POST.

Use POST for nested location filters. The body can be JSON or URL-encoded form data. Spends the account's monthly search or credit allowance; a Free plan has 50 searches, 50 credits and 100 verifications a month.

Found-only variant of email finder using request-body parameters. Spends the account's monthly search or credit allowance; a Free plan has 50 searches, 50 credits and 100 verifications a month.

Submit product feedback.

Creates a lead, or adds an existing lead to the requested lists. When an `email` matches a lead already on your team, the request is additive: it adds only the missing list memberships and returns 201 rather than an email duplicate error. When the matched lead belongs to a teammate, the request still adds it to your lists, and the teammate's lead itself is only updated if you have permission to edit it. A request without an `email` is never matched by email — it does not reuse an existing email-less lead — though a lead with an identical name, company, and list is still rejected as a duplicate. Accepts `department` since HUN-23171, normalized to its canonical key so a localized display label ("Sales") is stored as `sales`. Lead attributes are not modelled field-by-field in this contract yet — the response uses the generic resource envelope — so this note is where the accepted set is recorded. When another request is creating leads for the team, returns 409 with `lead_creation_in_progress` and `Retry-After: 1`. Retry the request after one second.

Delete leads in bulk.

Move leads to another list in bulk.

Enrich a lead. Spends the account's monthly search or credit allowance; a Free plan has 50 searches, 50 credits and 100 verifications a month.

Tag a lead.

Create a lead custom attribute.

Creates a draft leads import and returns its id, the guessed column matching, and a configuration_url. This call does not import anything: a person must open that URL in a browser and complete the mapping step before any lead is created. It is intended for clients that can hand off to a browser session, not for unattended automation. csv_data must be sent in the request body; it is rejected in the query string, where it would reach access logs verbatim.

Create a lead list.

Favorite a lead list.

Merge lead lists.

Create a lead list folder.

Create a message template.

Send a one-off message. SENDS REAL EMAIL from a connected email account to the addresses named. There is no draft or preview step.

Search professional email addresses across many companies at once using a structured filter set. Returns masked rows — no email address or phone number; use the reveal endpoint to unmask. This masked survey operation is free. At least one filter is required. Filters may be sent in the request body (JSON or form-encoded) or as query-string parameters; the body is therefore optional. Spends the account's monthly search or credit allowance; a Free plan has 50 searches, 50 credits and 100 verifications a month.

Reveal emails from a multi-domain search. Spends the account's monthly search or credit allowance; a Free plan has 50 searches, 50 credits and 100 verifications a month.

Create a sequence.

Add a sequence follow-up step.

Add sequence recipients.

Start a sequence. SENDS REAL EMAIL from a connected email account to the addresses named. There is no draft or preview step.

Archive a sequence.

Pause a sequence.

Create a lead tag.

Create a webhook.

Update account details. Changes settings for the whole Hunter account, not one record.

Replace a company list.

Replace a company list folder.

Replace a company tag.

Replace an email account.

Accepts `department`, normalized to its canonical key so a localized display label ("Sales") is stored as `sales`. This operation keeps its own allowlist, separate from the one `createLead` uses, so the two can differ — it does not currently accept `company_type`, `lead_country_code`, `lead_city` or `lead_state`. When creating a new lead while another request is creating leads for the team, returns 409 with `lead_creation_in_progress` and `Retry-After: 1`. Retry the request after one second. Existing leads can still be updated.

Create or update up to 100 leads in one call. Each lead is matched on `email` and written in its own transaction, so one invalid lead does not cancel the others. The team's lead limit is checked for each new lead using the current committed lead count. If an item would exceed that limit, earlier successful items remain saved and that item returns a `leads_limit_reached` error. If another request is creating leads for the team, the new lead's item returns `status: failed` with error `lead_creation_in_progress` and code 409. Retry only those failed items after one second; other items still run normally. The response is always 200: read `status` and `errors` of each result to know what happened to each lead. The call is free and consumes no request.

Accepts `department` since HUN-23171. The value is normalized to its canonical key, so a localized display label ("Sales") is stored as `sales`. Lead attributes are not modelled field-by-field in this contract yet — the response uses the generic resource envelope — so this note is where the accepted set is recorded.

Replace a lead custom attribute.

Replace a lead list.

Replace a lead list folder.

Replace a message template.

Replace a sequence.

Replace a sequence follow-up step.

Replace a lead tag.

Replace a webhook.