Hunter.io Toolkit
The Hunter.io Toolkit is a workflow node. Its tools include Search Domain Emails, Find Person's Email, Verify Email, Count Domain Emails, plus 11 more listed below. Create a connection before you use any of these tools. Type @ in a field when the value should come from an earlier step.
Authentication
Create a Hunter.io connection before you use any of these tools.
Copy an API key from Hunter.io
- Sign in and open hunter.io/api-keys.
- Copy the API key shown there.
Connect the key in EKB
- On the first Hunter.io node, open Connection.
- Click + New.
- Enter a Connection Name.
- Paste the API Key, or click the key button next to that field and select a vault key that already exists. If the key has not been created yet, add it first on the Datastore Vault tab.
- Select the new connection in Select saved connection.
Other nodes for this toolkit in the same workflow reuse that connection. To use another connection on one node, choose Configure different connection for this step.
Enter token manually saves the same credentials on that node instead of a saved connection.
Tools
Search Domain Emails
Find email addresses known for a domain or company.
| Field | Required | Description |
|---|---|---|
| Domain | No | Domain to find email addresses for, e.g. 'stripe.com'. Provide this OR company. If both are given, domain takes precedence. Type @ to select a variable. |
| Company | No | Company name to find email addresses for, e.g. 'stripe'. Providing domain instead gives better results. Type @ to select a variable. |
| Type | No | Restrict to 'personal' (a named person) or 'generic' (role-based, e.g. contact@) email addresses. Type @ to select a variable. |
| Seniority | No | Comma-delimited seniority filter. Valid values: 'junior', 'senior', 'executive'. Type @ to select a variable. |
| Department | No | Comma-delimited department filter. Valid values: 'executive', 'it', 'finance', 'management', 'sales', 'legal', 'support', 'hr', 'marketing', 'communication', 'education', 'design', 'health', 'operations', 'product', 'research', 'consulting', 'administrative', 'procurement'. Type @ to select a variable. |
| Decision Maker | No | True for only likely decision-makers (inferred from seniority/department), False for only explicitly non-decision-makers. Omit for no filter. Emails not yet classified match neither true nor false. Type @ to select a variable. |
| Job Titles | No | Comma-delimited job title(s) to match, e.g. 'CTO,VP Engineering'. Common executive titles match equivalents automatically (CTO ~ Chief Technology Officer). To target a whole tier of people, prefer seniority/department/decision_maker instead of listing titles. Type @ to select a variable. |
| Required Field | No | Comma-delimited field(s) each returned email must have. Valid values: 'full_name', 'position', 'phone_number'. Type @ to select a variable. |
| Verification Status | No | Comma-delimited verification status filter. Valid values: 'valid', 'accept_all', 'unknown'. Type @ to select a variable. |
| Location | No | Include or exclude locations by continent, business region, country, state, or city. Type @ to select a variable. |
| Aggregations | No | Set true to include a meta.aggregations breakdown (department counts, decision-maker count, personal/generic split) reflecting the filters applied. Omitted from the response entirely when there are 0 results, even if requested. Type @ to select a variable. |
| Limit | No | Max emails to return (default 10 server-side, max 100). Free plans cap limit+offset at 10 total — do not set this unless you need to change the default; sending even a smaller-than-default value can 400 on some plans. Type @ to select a variable. |
| Offset | No | Number of emails to skip, used with limit for pagination. Omit unless paginating. Type @ to select a variable. |
Find Person's Email
Find the most likely email address for a named person at a company.
| Field | Required | Description |
|---|---|---|
| Domain | No | Domain of the company, e.g. 'reddit.com'. Provide this, OR company, OR linkedin_handle. Type @ to select a variable. |
| Company | No | Company name, if domain is not known. Providing domain gives better results. Type @ to select a variable. |
| LinkedIn Handle | No | LinkedIn profile handle to find the email for. Satisfies both the domain/company requirement and the name requirement on its own. Type @ to select a variable. |
| First Name | No | Person's first name. Required (with last_name) unless full_name or linkedin_handle is given. Type @ to select a variable. |
| Last Name | No | Person's last name. Required (with first_name) unless full_name or linkedin_handle is given. Type @ to select a variable. |
| Full Name | No | Person's full name, used if first_name/last_name are not known. first_name+last_name give better results. Type @ to select a variable. |
| Max Duration | No | Max seconds Hunter spends refining the result (3-20, default 10). Longer can improve accuracy. Type @ to select a variable. |
Verify Email
Check whether one email address is deliverable.
| Field | Required | Description |
|---|---|---|
| Yes | Required. The email address to verify. Type @ to select a variable. |
Count Domain Emails
Count known email addresses for a domain, by department and seniority.
| Field | Required | Description |
|---|---|---|
| Domain | No | Domain to count known email addresses for, e.g. 'stripe.com'. Provide this OR company. Type @ to select a variable. |
| Company | No | Company name, if domain is not known. Type @ to select a variable. |
| Type | No | Count only 'personal' or only 'generic' email addresses. Type @ to select a variable. |
Email Insight
Read deliverability signals for an email address without a full verification.
| Field | Required | Description |
|---|---|---|
| Yes | Required. The email address to inspect. Type @ to select a variable. |
Find Company Domain
Resolve a company name to its likely domain.
| Field | Required | Description |
|---|---|---|
| Company | Yes | Required. Company name to resolve into a domain, e.g. 'stripe' or 'Y Combinator'. At least 3 characters. Type @ to select a variable. |
| Limit | No | Max number of candidate domains to return (1-10, default 5). Type @ to select a variable. |
| Perfect Match | No | Set true to return only very-high-similarity matches (useful for a single confident answer instead of a candidate list). Default false. Type @ to select a variable. |
Discover Companies
Find companies from a description or structured filters.
| Field | Required | Description |
|---|---|---|
| Query | No | Natural-language description of target companies, e.g. 'Companies in Europe in the Tech Industry'. Required unless at least one structured filter below is set. Type @ to select a variable. |
| Organization | No | ('domain': [...]) and/or ('name': [...]) to select specific companies. Type @ to select a variable. |
| Headquarters Location | No | ('include': [...], 'exclude': [...]), each entry ('continent'/'business_region'/'country'(+'state'+'city')). Type @ to select a variable. |
| Industry | No | ('include': [...], 'exclude': [...]) of industry names (see Hunter's industries.json for valid values). Type @ to select a variable. |
| Headcount | No | List of employee-count buckets to include, e.g. ['1-10','11-50']. Valid values: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+. Type @ to select a variable. |
| Company Type | No | ('include': [...], 'exclude': [...]) of company types: educational, educational institution, government agency, non profit, partnership, privately held, public company, self employed, self owned, sole proprietorship. Type @ to select a variable. |
| Keywords | No | ('include': [...], 'exclude': [...], 'match': 'any'/'all') keywords narrowing the company selection. Type @ to select a variable. |
| Job Openings | No | Filter by open job postings: ('hiring': bool, 'department': [...], 'job_title': ('include':[...],'exclude':[...]), 'posted_date': 'last7d'/'last30d'/'last90d', 'open_roles': ('from':int,'to':int), 'include_closed_roles': bool). Type @ to select a variable. |
| Year Founded | No | Premium plans only. ('include': [...]) and/or ('from': int, 'to': int). Type @ to select a variable. |
| Technology | No | Premium plans only. ('include': [...], 'exclude': [...], 'match': 'any'/'all') of technology slugs (see technologies.json). Type @ to select a variable. |
| Funding | No | Premium plans only. ('series': [...], 'amount': ('from':int,'to':int), 'date': ('from':str,'to':str)). Type @ to select a variable. |
| Similar To | No | Premium plans only. ('domain': str) or ('name': str) of a company to find similar companies for. Type @ to select a variable. |
| Limit | No | Premium plans only. max/default is 100. Omit entirely unless you know the account is Premium. Type @ to select a variable. |
| Offset | No | Premium plans only. Same caveat as limit — omit on a Free plan. Type @ to select a variable. |
Discover Reachable People
Find reachable people using the same filters as Discover Companies.
| Field | Required | Description |
|---|---|---|
| Query | No | Natural-language description of target companies. Required unless at least one structured filter below is set. Accepts the exact same filters as hunter_discover_companies. Type @ to select a variable. |
| Organization | No | Same shape as hunter_discover_companies' organization filter. Type @ to select a variable. |
| Headquarters Location | No | Same shape as hunter_discover_companies' headquarters_location filter. Type @ to select a variable. |
| Industry | No | Same shape as hunter_discover_companies' industry filter. Type @ to select a variable. |
| Headcount | No | Same shape as hunter_discover_companies' headcount filter. Type @ to select a variable. |
| Company Type | No | Same shape as hunter_discover_companies' company_type filter. Type @ to select a variable. |
| Keywords | No | Same shape as hunter_discover_companies' keywords filter. Type @ to select a variable. |
| Job Openings | No | Same shape as hunter_discover_companies' job_openings filter. Type @ to select a variable. |
| Year Founded | No | Premium plans only. Silently ignored on a Free plan — check filters_ignored in the response. Type @ to select a variable. |
| Technology | No | Premium plans only. Silently ignored on a Free plan. Type @ to select a variable. |
| Funding | No | Premium plans only. Silently ignored on a Free plan. Type @ to select a variable. |
| Similar To | No | Premium plans only. Silently ignored on a Free plan. Type @ to select a variable. |
| Limit | No | Premium plans only. omit on a Free plan (400 pagination_error otherwise). Type @ to select a variable. |
| Offset | No | Premium plans only. Omit on a Free plan. Type @ to select a variable. |
Search Across Companies
Search people across companies that match a set of filters.
| Field | Required | Description |
|---|---|---|
| Company Name | No | Comma-delimited company name(s) to restrict the search to. Type @ to select a variable. |
| Location | No | Comma-delimited ISO 3166-1 alpha-2 country code(s), e.g. 'US,GB'. Type @ to select a variable. |
| Industry | No | Comma-delimited numeric industry ID(s) from Hunter's industries.json (NOT names — this differs from Discover's industry filter). Type @ to select a variable. |
| Technology | No | Comma-delimited technology slug(s) from technologies.json. Type @ to select a variable. |
| Headcount | No | Comma-delimited headcount bucket(s): 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+. Type @ to select a variable. |
| Company Type | No | Comma-delimited company type(s): educational, educational institution, government agency, non profit, partnership, privately held, public company, self employed, self owned, sole proprietorship. Type @ to select a variable. |
| Founded Year | No | Comma-delimited four-digit founding year(s), 1000 up to next year. Type @ to select a variable. |
| Department | No | Comma-delimited department filter for the matched people: executive, it, finance, management, sales, legal, support, hr, marketing, communication, education, design, health, operations, product, research, consulting, administrative, procurement. Type @ to select a variable. |
| Seniority | No | Comma-delimited seniority filter: junior, senior, executive. Type @ to select a variable. |
| Type | No | Comma-delimited email type filter: personal, generic. Type @ to select a variable. |
| Decision Maker | No | Set true to restrict to likely decision-makers. Unlike Domain Search, there is no 'non-decision-makers' mode here — a falsy value is simply ignored. Type @ to select a variable. |
| Verification Status | No | Comma-delimited verification status filter: valid, accept_all, unknown. Type @ to select a variable. |
| Required Field | No | Comma-delimited field(s) every returned row must have: full_name, position, phone_number. Type @ to select a variable. |
| Min Confidence | No | Minimum confidence score, 2-100. Type @ to select a variable. |
| Limit | No | Max rows to return per page (default and max 100). Type @ to select a variable. |
| Search After | No | Pagination cursor from a previous call's meta.next_search_after. Omit for the first page. This endpoint does NOT support offset-based pagination. Type @ to select a variable. |
| Per Domain | No | Set true to include a meta.per_domain breakdown of matching email counts (top 1000 domains by count). Type @ to select a variable. |
Reveal Email
Reveal the email address for a handle returned by Search Across Companies.
| Field | Required | Description |
|---|---|---|
| Handles | Yes | Required. Up to 100 reveal_handle values from a hunter_multi_domain_search response. This spends 1 Hunter.io credit per personal email revealed (all generic addresses on one domain share a single credit) and is confirmation-gated. Type @ to select a variable. |
Enrich Person
Read what Hunter knows about a person from an email or LinkedIn handle.
| Field | Required | Description |
|---|---|---|
| No | Email address to enrich. Provide this OR linkedin_handle. If both given, linkedin_handle takes precedence. Type @ to select a variable. | |
| LinkedIn Handle | No | LinkedIn profile handle to enrich, if email is not known. Type @ to select a variable. |
Enrich Company
Read what Hunter knows about a company from its domain.
| Field | Required | Description |
|---|---|---|
| Domain | Yes | Required. Company domain to enrich, e.g. 'hunter.io'. Type @ to select a variable. |
Enrich Person and Company
Enrich a person and their company in one call.
| Field | Required | Description |
|---|---|---|
| No | Email address to enrich (person + their company). Provide this OR linkedin_handle. Type @ to select a variable. | |
| LinkedIn Handle | No | LinkedIn profile handle to enrich, if email is not known. Type @ to select a variable. |
Check API Usage
Read this account's plan and remaining searches, verifications, and credits.
Custom API Call
Call a Hunter.io v2 endpoint that is not covered by another tool.
| Field | Required | Description |
|---|---|---|
| Method | Yes | HTTP method: 'GET', 'POST', 'PUT', or 'DELETE'. Type @ to select a variable. |
| Path | Yes | API path relative to https://api.hunter.io/v2 (e.g. 'domains-suggestion', 'domain-count', 'usage', 'account-stats', 'team/members'). Leading slash optional. Type @ to select a variable. |
| Query | No | Query parameters to append to the URL. Type @ to select a variable. |
| Body | No | JSON body for POST/PUT. Type @ to select a variable. |
Related
See all integrations on the toolkits overview.