> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Hunter

> Hunter is an email marketing company specializing in lead generation and data enrichment.

![Hunter logo](https://mintcdn.com/composio-preview/o1IUBrrsmtgkhmyf/images/toolkits/hunter.svg?fit=max\&auto=format\&n=o1IUBrrsmtgkhmyf\&q=85\&s=805e7cfb228cbd7711f55e485050cb4f)

* **Category:** people & contact data
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 39
* **Triggers:** 0
* **Slug:** `HUNTER`
* **Version:** 20261103\_00
* **Instant:** Supported on the latest version. Support varies by tool.

## Tools

> [accordion] Account Information
>
> **Slug:** `HUNTER_ACCOUNT_INFORMATION`
>
> Retrieve Hunter account plan details and search and verification usage allocations. The available fields represent total allocations, not remaining balances.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Combined Enrichment
>
> **Slug:** `HUNTER_COMBINED_ENRICHMENT`
>
> Retrieve person and company enrichment using an email address or LinkedIn handle. Managed calls require email only and redact personal phone and location information.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.004 per billed combined enrichment
>
> **Discount:** 40
>
> #### Input Parameters
>
> **email** `string`
>
> The professional's email address to enrich. Either email or linkedin must be provided.
>
> **linkedin** `string`
>
> LinkedIn handle as alternative to email. Either email or linkedin must be provided.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Company Enrichment
>
> **Slug:** `HUNTER_COMPANY_ENRICHMENT`
>
> Tool to get enrichment information for a company by its domain. Use when you need full company details (industry, description, location, metrics) from Hunter.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.004 per billed company enrichment
>
> **Discount:** 40
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> The domain name for which to retrieve company information. Must be a bare domain (e.g., 'hunter.io') without protocol prefix (https\://) or www subdomain.
>
> **clearbit\_format** `string`
>
> When provided, the response will be formatted according to Clearbit's schema.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create custom lead attribute
>
> **Slug:** `HUNTER_CREATE_CUSTOM_ATTRIBUTE`
>
> Tool to create a new custom lead attribute in your account. Use after deciding on the attribute label.
>
> #### Input Parameters
>
> **label** `string` *required*
>
> The name (label) of your custom attribute. Must be unique.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Lead
>
> **Slug:** `HUNTER_CREATE_LEAD`
>
> Create a lead in your Hunter account using an email address and optional prospect details. If the email already belongs to a team lead, the request can add missing list memberships instead of creating a duplicate.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> The email address of the lead
>
> **notes** `string`
>
> Internal notes about the lead
>
> **source** `string`
>
> Source where the lead was found
>
> **company** `string`
>
> Company name of the lead
>
> **twitter** `string`
>
> Twitter handle of the lead (without @)
>
> **website** `string`
>
> Domain of the lead's company, e.g. 'reddit.com'
>
> **position** `string`
>
> Job title of the lead
>
> **last\_name** `string`
>
> Last name of the lead
>
> **first\_name** `string`
>
> First name of the lead
>
> **company\_size** `string`
>
> Size of the company, e.g. '201-500 employees'
>
> **country\_code** `string`
>
> ISO 3166-1 alpha-2 country code
>
> **linkedin\_url** `string`
>
> Public LinkedIn profile URL of the lead
>
> **phone\_number** `string`
>
> Phone number of the lead
>
> **leads\_list\_id** `integer`
>
> ID of a single leads list. Defaults to the last list created if unset
>
> **leads\_list\_ids** `array`
>
> IDs of multiple leads lists. Defaults to the last list created if unset
>
> **company\_industry** `string`
>
> Industry of the company, e.g. 'Technology', 'Finance'
>
> **confidence\_score** `integer`
>
> Probability (0–100) that the email is correct
>
> **custom\_attributes** `object`
>
> Map of custom attribute slug to value
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Leads List
>
> **Slug:** `HUNTER_CREATE_LEADS_LIST`
>
> Tool to create a new leads list. Use when you need to organize leads into a custom list before adding leads.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the leads list to create.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Custom Attribute
>
> **Slug:** `HUNTER_DELETE_CUSTOM_ATTRIBUTE`
>
> Tool to delete an existing custom attribute. Use after confirming the attribute ID to be removed.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Identifier of the custom attribute to be deleted
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Lead
>
> **Slug:** `HUNTER_DELETE_LEAD`
>
> Tool to delete a lead. Use after confirming the lead's ID to remove it from your Hunter.io account.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The unique identifier of the lead to be deleted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Leads List
>
> **Slug:** `HUNTER_DELETE_LEADS_LIST`
>
> Tool to delete a leads list by its ID. Use after confirming the leads list ID to remove it from your Hunter.io account.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Identifier of the leads list to be deleted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Discover Companies
>
> **Slug:** `HUNTER_DISCOVER_COMPANIES`
>
> Tool to search and retrieve companies matching specified criteria using filters or natural language queries. Use when you need to discover companies from Hunter's B2B dataset based on industry, location, size, or other characteristics.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0 per request
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of results to return. Default is 100. Only changeable with Premium.
>
> **query** `string`
>
> Natural language search query to find companies. Either query or at least one filter parameter must be provided.
>
> **offset** `integer`
>
> Number of results to skip for pagination. Default is 0. Premium feature only.
>
> **headcount** `array`
>
> Company sizes. Valid values: '1-10', '11-50', '51-200', '201-500', '501-1000', '1001-5000', '5001-10000', '10001+'.
>
> **funding\_series** `array`
>
> Funding stages: pre\_seed, seed, series\_a, series\_b+, etc. Premium feature only.
>
> **keywords\_match** `string ("any" | "all")`
>
> Keyword matching mode. Defaults to 'all'.
>
> **funding\_date\_to** `string`
>
> Funding end date in YYYY-MM-DD format. Premium feature only.
>
> **similar\_to\_name** `string`
>
> Company name to find similar firms. Premium feature only.
>
> **year\_founded\_to** `integer`
>
> Range end year for company founding. Premium feature only.
>
> **industry\_exclude** `array`
>
> Industries to exclude. Use specific industry names like 'IT Services and IT Consulting', 'Financial Services', 'Hospitals and Health Care', 'Construction', 'Restaurants', 'Real Estate', etc. See Hunter's industries.json for the complete list of valid values.
>
> **industry\_include** `array`
>
> Industries to include. Use specific industry names like 'IT Services and IT Consulting', 'Financial Services', 'Hospitals and Health Care', 'Construction', 'Restaurants', 'Real Estate', etc. See Hunter's industries.json for the complete list of valid values.
>
> **keywords\_exclude** `array`
>
> Keywords to exclude from search.
>
> **keywords\_include** `array`
>
> Keywords to include in search.
>
> **technology\_match** `string ("any" | "all")`
>
> Technology matching mode. Defaults to 'all'.
>
> **funding\_amount\_to** `number`
>
> Maximum funding amount. Premium feature only.
>
> **funding\_date\_from** `string`
>
> Funding start date in YYYY-MM-DD format. Premium feature only.
>
> **organization\_name** `array`
>
> List of company names to filter by.
>
> **similar\_to\_domain** `string`
>
> Domain of company to find similar firms. Premium feature only.
>
> **year\_founded\_from** `integer`
>
> Range start year for company founding. Premium feature only.
>
> **technology\_exclude** `array`
>
> Technologies to exclude. Premium feature only.
>
> **technology\_include** `array`
>
> Technologies to include. Premium feature only.
>
> **funding\_amount\_from** `number`
>
> Minimum funding amount. Premium feature only.
>
> **organization\_domain** `array`
>
> List of company domains to filter by.
>
> **company\_type\_exclude** `array`
>
> Company types to exclude.
>
> **company\_type\_include** `array`
>
> Company types to include (educational, government agency, non profit, etc.).
>
> **year\_founded\_include** `array`
>
> Specific years founded. Premium feature only.
>
> **headquarters\_location\_exclude** `array`
>
> Locations to exclude.
>
> **headquarters\_location\_include** `array`
>
> Locations to include (continent, business\_region, country, state, city).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Domain Search
>
> **Slug:** `HUNTER_DOMAIN_SEARCH`
>
> Search Hunter email addresses and metadata for a domain or company, including found and inferred addresses. Managed searches requesting more than 10 results require a trusted paid-plan grant; managed results omit phone numbers.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.024 per search returning 1-10 emails; free if none found.
>
> **Discount:** 50
>
> #### Input Parameters
>
> **type** `string`
>
> Filter by email type. Either 'personal' or 'generic'.
>
> **limit** `integer`
>
> Maximum number of email addresses to return. Default is 10, which is the maximum for free/basic plans. Values above 10 require a paid plan and will fail on free/basic tiers.
>
> **domain** `string`
>
> Domain name to search for. Required if company not provided.
>
> **offset** `integer`
>
> Number of email addresses to skip. Defaults to 0. Paginate by incrementing offset in steps of limit; end of results when returned count is less than limit.
>
> **company** `string`
>
> Company name to search for. Required if domain not provided.
>
> **seniority** `array`
>
> Filter by one or more seniority levels: 'junior','senior','executive'.
>
> **department** `array`
>
> Filter by one or more departments, e.g., 'executive','it','finance', etc.
>
> **required\_field** `array`
>
> Filter by one or more required fields: 'full\_name','position','phone\_number'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Email Count
>
> **Slug:** `HUNTER_EMAIL_COUNT`
>
> Tool to get the total number of email addresses Hunter has for a domain or company with breakdowns by type, department, and seniority. Use when you need email volume statistics (free; no charge).
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0 per request
>
> #### Input Parameters
>
> **type** `string`
>
> Filter results to 'personal' or 'generic' emails only.
>
> **domain** `string`
>
> Domain name to query for email count. Required if company not provided.
>
> **company** `string`
>
> Company name to query for email count (minimum 3 characters). Required if domain not provided.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Email Finder
>
> **Slug:** `HUNTER_EMAIL_FINDER`
>
> Find the most likely email address for a named person at a domain or company, with a confidence score and verification status when available. No credit is charged if no email is found.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.024 per email found
>
> **Discount:** 50
>
> #### Input Parameters
>
> **domain** `string`
>
> Target domain to search for the email (e.g., 'reddit.com'). Takes precedence over company if both are provided.
>
> **company** `string`
>
> Company name to search for the email (e.g., 'Reddit'). Used if domain is not provided.
>
> **full\_name** `string`
>
> Person's full name. Required if first\_name and last\_name are not both provided.
>
> **last\_name** `string`
>
> Person's last name. Required if first\_name is set. Either both first\_name+last\_name or full\_name must be provided.
>
> **first\_name** `string`
>
> Person's first name. Required if last\_name is set. Either both first\_name+last\_name or full\_name must be provided.
>
> **max\_duration** `integer`
>
> Max duration of the request in seconds (range 320). Longer durations yield more accurate results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Email Verifier
>
> **Slug:** `HUNTER_EMAIL_VERIFIER`
>
> Tool to verify the deliverability of an email address. Use when you need to ensure an address is valid and reachable. Hunter may return a pending response without data and with meta.message; call again with the same email until data is returned. Hunter counts these calls as one verification. Use data.status for the completed result: valid, invalid, accept\_all, webmail, disposable, or unknown. Do not treat accept\_all, webmail, disposable, or unknown as confirmed deliverability. The deprecated data.result may contain deliverable, undeliverable, or risky; prefer data.status. For bulk verification, honor `Retry-After` headers on HTTP 429 responses and use exponential backoff.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.012 per billed email verification
>
> **Discount:** 50
>
> #### Input Parameters
>
> **email** `string` *required*
>
> The email address to verify.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Custom Attribute
>
> **Slug:** `HUNTER_GET_CUSTOM_ATTRIBUTE`
>
> Tool to retrieve details of a specific custom attribute. Use when you need the label and slug for an attribute ID.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Identifier of the custom attribute, must be a positive integer
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Email Account Capacities
>
> **Slug:** `HUNTER_GET_EMAIL_ACCOUNT_CAPACITIES`
>
> Get today's sending capacity from Hunter's Beta Email Accounts API. Returns provider counts and a zero-floored `available` value derived as `daily_limit - sent - scheduled` for every visible account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Email Account Usage
>
> **Slug:** `HUNTER_GET_EMAIL_ACCOUNT_USAGE`
>
> Get today's sending usage, seven-day history, and remaining capacity for one account through Hunter's Beta Email Accounts API.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Positive identifier of the email account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Lead
>
> **Slug:** `HUNTER_GET_LEAD`
>
> Tool to retrieve details of a specific lead by ID. Use after confirming the lead's ID to fetch its full record.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The unique identifier of the lead to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Leads List
>
> **Slug:** `HUNTER_GET_LEADS_LIST`
>
> Tool to retrieve details of a specific leads list by ID. Use when you need to inspect the contents of an existing leads list.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Identifier of the leads list.
>
> **limit** `integer`
>
> A limit on the number of leads to return. Limit can range between 1 and 100.
>
> **offset** `integer`
>
> The number of leads to skip. Use this parameter to fetch paginated results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Sequence
>
> **Slug:** `HUNTER_GET_SEQUENCE`
>
> Retrieve the full configuration of a sequence by ID.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The positive identifier of the sequence to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Usage
>
> **Slug:** `HUNTER_GET_USAGE`
>
> Get usage through Hunter's Beta API. Depending on the plan, returns unified API credits or separate search and verification balances.
>
> #### Input Parameters
>
> **show\_overage\_requests** `boolean`
>
> Include over-quota request counts when the plan supports overage requests.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Webhook
>
> **Slug:** `HUNTER_GET_WEBHOOK`
>
> Retrieve one webhook registration by ID through Hunter's Beta Webhooks API.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The positive identifier of the webhook to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Campaigns
>
> **Slug:** `HUNTER_LIST_CAMPAIGNS`
>
> Tool to get all email campaigns in your Hunter account. Campaigns are returned in reverse-chronological order by creation date. Use when you need to retrieve and filter campaigns by status (started/archived) with pagination support.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Number of campaigns to return. Range between 1 and 100. Defaults to 20.
>
> **offset** `integer`
>
> Number of campaigns to skip for pagination. Defaults to 0.
>
> **started** `boolean`
>
> Filter to only return campaigns that have been started. If true, returns only started campaigns. If false, returns only campaigns that have not been started.
>
> **archived** `boolean`
>
> Filter to only return campaigns that have been archived. If true, returns only archived campaigns. If false, returns only campaigns that have not been archived.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Companies
>
> **Slug:** `HUNTER_LIST_COMPANIES`
>
> List companies saved in the authenticated Hunter account.
>
> #### Input Parameters
>
> **sort** `string ("company_name" | "website" | "company_size" | "company_type" | "leads_count" | "created_at" | "updated_at" | "last_exported_at" | "last_funding_date")`
>
> Column used to sort matching companies.
>
> **tags** `array`
>
> Company tag identifiers. Multiple values are sent pipe-delimited.
>
> **limit** `integer`
>
> Maximum number of companies to return (1-100). Defaults to 20.
>
> **query** `string`
>
> Free-text search across company names and domains.
>
> **offset** `integer`
>
> Number of companies to skip (0-9999). Defaults to 0.
>
> **source** `string`
>
> Match companies whose source contains this value.
>
> **country** `array`
>
> ISO 3166 alpha-2 country codes. Multiple values are sent pipe-delimited.
>
> **website** `string`
>
> Match companies whose domain contains this value.
>
> **industry** `array`
>
> Industry category or subcategory identifiers. Multiple values are sent pipe-delimited.
>
> **keywords** `string`
>
> Text to match in company descriptions or keywords.
>
> **location** `string`
>
> Match a city, state, country, or continent name.
>
> **direction** `string ("asc" | "desc")`
>
> Sort direction. Defaults to ascending at the provider and is used only when sort is provided.
>
> **technology** `array`
>
> TechLookup technology slugs. Use '\~' for no technology or '\*' for any present technology. Multiple values are sent pipe-delimited.
>
> **leads\_count** `object`
>
> Inclusive range of leads tracked for a company. Serialized as minimum:maximum.
>
> **company\_name** `string`
>
> Match companies whose name contains this value.
>
> **company\_size** `array`
>
> Company-size buckets. Use '\~' for an empty value or '\*' for any present value. Multiple values are sent pipe-delimited.
>
> **company\_type** `array`
>
> Company types, such as 'privately held' or 'public company'. Multiple values are sent pipe-delimited.
>
> **founded\_year** `object`
>
> Inclusive founding-year range, serialized as minimum:maximum. Requires the founded-year filter entitlement; otherwise Hunter ignores it.
>
> **funding\_amount** `object`
>
> Inclusive total-funding range, serialized as minimum:maximum. Requires the funding filter entitlement; otherwise Hunter ignores it.
>
> **funding\_series** `array`
>
> Funding series, sent pipe-delimited. Requires the funding filter entitlement; otherwise Hunter ignores it.
>
> **company\_list\_ids** `array`
>
> Company-list IDs used to filter saved companies. Lists must belong to the authenticated team. Multiple IDs are sent pipe-delimited.
>
> **last\_funding\_date** `object`
>
> Inclusive last-funding date range, serialized as start:end. Requires the funding filter entitlement; otherwise Hunter ignores it.
>
> **location\_city\_excluded** `array`
>
> Cities to exclude. Multiple values are sent pipe-delimited.
>
> **location\_city\_included** `array`
>
> Cities to include. Multiple values are sent pipe-delimited.
>
> **location\_state\_excluded** `array`
>
> States to exclude. Multiple values are sent pipe-delimited.
>
> **location\_state\_included** `array`
>
> States to include. Multiple values are sent pipe-delimited.
>
> **location\_country\_excluded** `array`
>
> Countries to exclude. Multiple values are sent pipe-delimited.
>
> **location\_country\_included** `array`
>
> Countries to include. Multiple values are sent pipe-delimited.
>
> **location\_continent\_excluded** `array`
>
> Continents to exclude. Multiple values are sent pipe-delimited.
>
> **location\_continent\_included** `array`
>
> Continents to include. Multiple values are sent pipe-delimited.
>
> **location\_business\_region\_excluded** `array`
>
> Business regions to exclude. Multiple values are sent pipe-delimited.
>
> **location\_business\_region\_included** `array`
>
> Business regions to include. Multiple values are sent pipe-delimited.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Custom Attributes
>
> **Slug:** `HUNTER_LIST_CUSTOM_ATTRIBUTES`
>
> Tool to list all custom lead attributes in your account. Use when you need to retrieve your account's custom lead attributes after authenticating.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Email Accounts
>
> **Slug:** `HUNTER_LIST_EMAIL_ACCOUNTS`
>
> List sending accounts through Hunter's paginated Beta API. Paid plans expose team accounts; Free plans expose only accounts owned by the API-key user.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Number of email accounts to return (1-100). Defaults to 20.
>
> **offset** `integer`
>
> Number of email accounts to skip. Defaults to 0.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Email Account Sequences
>
> **Slug:** `HUNTER_LIST_EMAIL_ACCOUNT_SEQUENCES`
>
> List sequences that use one email account, including recipients allocated to that account and emails still scheduled from it. Use this account-dependency view instead of the global sequence list when evaluating sender capacity or account changes.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Positive identifier of the email account.
>
> **limit** `integer`
>
> Number of sequences to return (1-100). Defaults to 20.
>
> **offset** `integer`
>
> Number of sequences to skip for pagination. Defaults to 0.
>
> **include\_archived** `boolean`
>
> Whether to include archived sequences. They are excluded by default.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Leads
>
> **Slug:** `HUNTER_LIST_LEADS`
>
> Tool to list all leads saved in your account with optional filters. Use when you need to retrieve leads with specific criteria after confirming your API key.
>
> #### Input Parameters
>
> **email** `string`
>
> Filter leads by email address.
>
> **limit** `integer`
>
> Number of leads to return (1-1000). Defaults to 20.
>
> **query** `string`
>
> Search leads by first name, last name, or email.
>
> **offset** `integer`
>
> Number of leads to skip for pagination (0-100000). Defaults to 0.
>
> **company** `string`
>
> Filter leads by company name.
>
> **twitter** `string`
>
> Filter leads by Twitter handle.
>
> **website** `string`
>
> Filter leads by company website.
>
> **position** `string`
>
> Filter leads by position.
>
> **last\_name** `string`
>
> Filter leads by last name.
>
> **created\_at** `string`
>
> Filter leads by creation date (ISO-8601 format).
>
> **first\_name** `string`
>
> Filter leads by first name.
>
> **country\_code** `string`
>
> Filter leads by country code (ISO 3166-1 alpha-2).
>
> **linkedin\_url** `string`
>
> Filter leads by LinkedIn profile URL.
>
> **phone\_number** `string`
>
> Filter leads by phone number.
>
> **leads\_list\_id** `integer`
>
> Filter leads by a specific leads list ID.
>
> **last\_activity\_at** `string`
>
> Filter leads by last activity date (ISO-8601 format).
>
> **custom\_attributes** `array`
>
> Filter leads by custom attributes.
>
> **last\_contacted\_at** `string`
>
> Filter leads by last contacted date (ISO-8601 format).
>
> **max\_confidence\_score** `integer`
>
> Filter leads with a maximum confidence score (0-100).
>
> **min\_confidence\_score** `integer`
>
> Filter leads with a minimum confidence score (0-100).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Leads Lists
>
> **Slug:** `HUNTER_LIST_LEADS_LISTS`
>
> Tool to list all leads lists in your account. Use when you need to retrieve and paginate through your leads lists.
>
> #### Input Parameters
>
> **limit** `integer`
>
> A limit on the number of leads lists to be returned. Range between 1 and 100. Defaults to 20.
>
> **offset** `integer`
>
> The number of leads lists to skip for pagination. Defaults to 0.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Messages
>
> **Slug:** `HUNTER_LIST_MESSAGES`
>
> List outreach messages or incoming replies with filters and pagination. Hunter returns outgoing messages by default; select the incoming direction to retrieve replies.
>
> #### Input Parameters
>
> **read** `boolean`
>
> Filter by read state.
>
> **limit** `integer`
>
> Number of messages to return. Range between 1 and 100. Defaults to 20.
>
> **query** `string`
>
> Full-text search across message subjects and bodies.
>
> **offset** `integer`
>
> Number of messages to skip for pagination. Defaults to 0.
>
> **status** `array`
>
> Delivery statuses to include.
>
> **bounced** `boolean`
>
> Filter by bounce state.
>
> **lead\_id** `integer`
>
> Filter by lead identifier.
>
> **replied** `boolean`
>
> Filter by reply state.
>
> **direction** `string ("outgoing" | "incoming")`
>
> Message direction. Hunter returns outgoing messages by default.
>
> **sent\_after** `string`
>
> ISO 8601 lower bound for the message send time.
>
> **campaign\_id** `integer`
>
> Backward-compatible alias for sequence\_id.
>
> **sent\_before** `string`
>
> ISO 8601 upper bound for the message send time.
>
> **sequence\_id** `integer`
>
> Filter by sequence identifier.
>
> **unsubscribed** `boolean`
>
> Filter by unsubscribe state.
>
> **out\_of\_office** `boolean`
>
> Filter incoming out-of-office responses.
>
> **received\_after** `string`
>
> ISO 8601 lower bound for incoming message receipt time.
>
> **received\_before** `string`
>
> ISO 8601 upper bound for incoming message receipt time.
>
> **email\_account\_id** `integer`
>
> Filter by connected email account identifier.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Sequences
>
> **Slug:** `HUNTER_LIST_SEQUENCES`
>
> List Hunter sequences with optional status filters and offset pagination. Sequences whose owners have been removed from the team are excluded.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Number of sequences to return. Range between 1 and 100. Defaults to 20.
>
> **offset** `integer`
>
> Number of sequences to skip for pagination. Defaults to 0.
>
> **started** `boolean`
>
> Filter sequences by whether they have been started.
>
> **archived** `boolean`
>
> Filter sequences by whether they have been archived.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Team Members
>
> **Slug:** `HUNTER_LIST_TEAM_MEMBERS`
>
> List Hunter team-member IDs, names, and emails through the paginated Beta API.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of team members to return (1-100). Defaults to 20.
>
> **offset** `integer`
>
> Number of team members to skip. Defaults to 0.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Usage History
>
> **Slug:** `HUNTER_LIST_USAGE_HISTORY`
>
> List one page of up to 100 credit-consuming requests from Hunter's last two years of Beta usage history. Offset pagination exposes at most 1,000 records. Members see their own history; admins and owners can filter team history by user ID.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of usage records to return (1-100). Defaults to 20.
>
> **offset** `integer`
>
> Number of usage records to skip (0-999). Defaults to 0.
>
> **user\_id** `integer`
>
> Positive team-member identifier to restrict the history to.
>
> **end\_date** `string`
>
> Only return requests made on or before this date (YYYY-MM-DD).
>
> **start\_date** `string`
>
> Only return requests made on or after this date (YYYY-MM-DD).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Webhooks
>
> **Slug:** `HUNTER_LIST_WEBHOOKS`
>
> List webhook registrations through Hunter's paginated Beta API without creating or changing them.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of webhooks to return (1-100). Defaults to 20.
>
> **offset** `integer`
>
> Number of webhooks to skip. Defaults to 0.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] People Enrichment
>
> **Slug:** `HUNTER_PEOPLE_ENRICHMENT`
>
> Enrich a person by email address or LinkedIn handle with available details such as name, job title, and social handles. Managed responses omit location and phone details.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.004 per billed person enrichment
>
> **Discount:** 40
>
> #### Input Parameters
>
> **email** `string`
>
> The email address for which to find associated information. At least one of email or linkedin\_handle must be provided.
>
> **clearbit\_format** `boolean`
>
> When provided, formats response to match Clearbit's schema for consistency.
>
> **linkedin\_handle** `string`
>
> The LinkedIn profile handle for which to find associated information. LinkedIn handle takes priority when both email and linkedin\_handle are provided. At least one of email or linkedin\_handle must be provided.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Custom Attribute
>
> **Slug:** `HUNTER_UPDATE_CUSTOM_ATTRIBUTE`
>
> Tool to update an existing custom attribute's label. Use when renaming a custom attribute after creation.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Identifier of the custom attribute, must be a positive integer
>
> **label** `string` *required*
>
> The new label for the custom attribute. Must be unique.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Lead
>
> **Slug:** `HUNTER_UPDATE_LEAD`
>
> Tool to update details of an existing lead by ID. Use when you need to modify saved lead attributes after creation.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Identifier of the lead to update, must be a positive integer
>
> **email** `string`
>
> Email address of the lead
>
> **notes** `string`
>
> Personal notes about the lead
>
> **source** `string`
>
> Source where the lead was found
>
> **company** `string`
>
> Company name of the lead
>
> **twitter** `string`
>
> Twitter handle of the lead
>
> **website** `string`
>
> Website or domain of the lead's company, e.g. 'reddit.com'
>
> **position** `string`
>
> Job title of the lead
>
> **last\_name** `string`
>
> Last name of the lead
>
> **first\_name** `string`
>
> First name of the lead
>
> **company\_size** `string`
>
> Size category of the lead's company, e.g. '201-500 employees'
>
> **country\_code** `string`
>
> ISO 3166-1 alpha-2 country code of the lead
>
> **linkedin\_url** `string`
>
> LinkedIn profile URL of the lead
>
> **phone\_number** `string`
>
> Phone number of the lead
>
> **leads\_list\_id** `integer`
>
> Identifier of a leads list to assign the lead to
>
> **leads\_list\_ids** `array`
>
> Identifiers of multiple leads lists to assign the lead to
>
> **company\_industry** `string`
>
> Industry sector of the lead's company, e.g. 'Technology', 'Finance'
>
> **confidence\_score** `integer`
>
> Confidence score (0–100) that the email address is correct
>
> **custom\_attributes** `object`
>
> Map of custom attribute slugs to their values
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Leads List
>
> **Slug:** `HUNTER_UPDATE_LEADS_LIST`
>
> Tool to update the name of a specific leads list. Use when renaming an existing leads list.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Identifier of the leads list to update, must be a positive integer
>
> **name** `string` *required*
>
> The new name for the leads list
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upsert Lead
>
> **Slug:** `HUNTER_UPSERT_LEAD`
>
> Tool to create or update a lead by email in one call. Use when you want to ensure a lead exists with the provided information without checking its existence first.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> The email address of the lead
>
> **notes** `string`
>
> Internal notes about the lead
>
> **source** `string`
>
> Source where the lead was found
>
> **company** `string`
>
> Company name of the lead
>
> **twitter** `string`
>
> Twitter handle of the lead (without @)
>
> **website** `string`
>
> Domain of the lead's company, e.g., 'reddit.com'
>
> **position** `string`
>
> Job title of the lead
>
> **last\_name** `string`
>
> Last name of the lead
>
> **first\_name** `string`
>
> First name of the lead
>
> **company\_size** `string`
>
> Size of the company, e.g., '201-500 employees'
>
> **country\_code** `string`
>
> ISO 3166-1 alpha-2 country code
>
> **linkedin\_url** `string`
>
> Public LinkedIn profile URL of the lead
>
> **phone\_number** `string`
>
> Phone number of the lead
>
> **leads\_list\_id** `integer`
>
> ID of a single leads list. Defaults to the last list created if unset
>
> **leads\_list\_ids** `array`
>
> IDs of multiple leads lists. Defaults to the last list created if unset
>
> **company\_industry** `string`
>
> Industry of the company, e.g., 'Technology', 'Finance'
>
> **confidence\_score** `integer`
>
> Probability (0–100) that the email is correct
>
> **custom\_attributes** `object`
>
> Map of custom attribute slug to value
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
