# Hunter

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

- **Category:** email
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 26
- **Triggers:** 0
- **Slug:** `HUNTER`
- **Version:** 20260316_00

## Tools

### Account Information

**Slug:** `HUNTER_ACCOUNT_INFORMATION`

Tool to retrieve information about your Hunter account. Use when you need to check your plan details and usage limits after confirming credentials. Returns `searches.available` and `verifications.available` fields among others; check these before bulk operations to avoid quota exhaustion.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Combined Enrichment

**Slug:** `HUNTER_COMBINED_ENRICHMENT`

Tool to find both person and company information from an email address or LinkedIn handle in a single request. Use when you need complete professional profile enrichment including employment and company details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | The professional's email address to enrich. Either email or linkedin must be provided. |
| `linkedin` | string | No | LinkedIn handle as alternative to email. Either email or linkedin must be provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | Yes | 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 | No | When provided, the response will be formatted according to Clearbit's schema. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `label` | string | Yes | The name (label) of your custom attribute. Must be unique. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Lead

**Slug:** `HUNTER_CREATE_LEAD`

Tool to create a new lead. Use after gathering all prospect details to save them to your Hunter account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | The email address of the lead |
| `notes` | string | No | Internal notes about the lead |
| `source` | string | No | Source where the lead was found |
| `company` | string | No | Company name of the lead |
| `twitter` | string | No | Twitter handle of the lead (without @) |
| `website` | string | No | Domain of the lead's company, e.g. 'reddit.com' |
| `position` | string | No | Job title of the lead |
| `last_name` | string | No | Last name of the lead |
| `first_name` | string | No | First name of the lead |
| `company_size` | string | No | Size of the company, e.g. '201-500 employees' |
| `country_code` | string | No | ISO 3166-1 alpha-2 country code |
| `linkedin_url` | string | No | Public LinkedIn profile URL of the lead |
| `phone_number` | string | No | Phone number of the lead |
| `leads_list_id` | integer | No | ID of a single leads list. Defaults to the last list created if unset |
| `leads_list_ids` | array | No | IDs of multiple leads lists. Defaults to the last list created if unset |
| `company_industry` | string | No | Industry of the company, e.g. 'Technology', 'Finance' |
| `confidence_score` | integer | No | Probability (0–100) that the email is correct |
| `custom_attributes` | object | No | Map of custom attribute slug to value |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The name of the leads list to create. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Identifier of the custom attribute to be deleted |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The unique identifier of the lead to be deleted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Identifier of the leads list to be deleted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return. Default is 100. Only changeable with Premium. |
| `query` | string | No | Natural language search query to find companies. Either query or at least one filter parameter must be provided. |
| `offset` | integer | No | Number of results to skip for pagination. Default is 0. Premium feature only. |
| `headcount` | array | No | Company sizes. Valid values: '1-10', '11-50', '51-200', '201-500', '501-1000', '1001-5000', '5001-10000', '10001+'. |
| `funding_series` | array | No | Funding stages: pre_seed, seed, series_a, series_b+, etc. Premium feature only. |
| `keywords_match` | string ("any" | "all") | No | Keyword matching mode. Defaults to 'all'. |
| `funding_date_to` | string | No | Funding end date in YYYY-MM-DD format. Premium feature only. |
| `similar_to_name` | string | No | Company name to find similar firms. Premium feature only. |
| `year_founded_to` | integer | No | Range end year for company founding. Premium feature only. |
| `industry_exclude` | array | No | 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 | No | 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 | No | Keywords to exclude from search. |
| `keywords_include` | array | No | Keywords to include in search. |
| `technology_match` | string ("any" | "all") | No | Technology matching mode. Defaults to 'all'. |
| `funding_amount_to` | number | No | Maximum funding amount. Premium feature only. |
| `funding_date_from` | string | No | Funding start date in YYYY-MM-DD format. Premium feature only. |
| `organization_name` | array | No | List of company names to filter by. |
| `similar_to_domain` | string | No | Domain of company to find similar firms. Premium feature only. |
| `year_founded_from` | integer | No | Range start year for company founding. Premium feature only. |
| `technology_exclude` | array | No | Technologies to exclude. Premium feature only. |
| `technology_include` | array | No | Technologies to include. Premium feature only. |
| `funding_amount_from` | number | No | Minimum funding amount. Premium feature only. |
| `organization_domain` | array | No | List of company domains to filter by. |
| `company_type_exclude` | array | No | Company types to exclude. |
| `company_type_include` | array | No | Company types to include (educational, government agency, non profit, etc.). |
| `year_founded_include` | array | No | Specific years founded. Premium feature only. |
| `headquarters_location_exclude` | array | No | Locations to exclude. |
| `headquarters_location_include` | array | No | Locations to include (continent, business_region, country, state, city). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Domain Search

**Slug:** `HUNTER_DOMAIN_SEARCH`

Tool to search all email addresses for a given domain or company. Use when you need public emails and metadata for outreach or enrichment. Rate-limited; HTTP 429 returned on excess requests — honor the Retry-After header.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string | No | Filter by email type. Either 'personal' or 'generic'. |
| `limit` | integer | No | 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 | No | Domain name to search for. Required if company not provided. |
| `offset` | integer | No | 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 | No | Company name to search for. Required if domain not provided. |
| `seniority` | array | No | Filter by one or more seniority levels: 'junior','senior','executive'. |
| `department` | array | No | Filter by one or more departments, e.g., 'executive','it','finance', etc. |
| `required_field` | array | No | Filter by one or more required fields: 'full_name','position','phone_number'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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 without consuming API credits (this call is free).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string | No | Filter results to 'personal' or 'generic' emails only. |
| `domain` | string | No | Domain name to query for email count. Required if company not provided. |
| `company` | string | No | Company name to query for email count (minimum 3 characters). Required if domain not provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Email Finder

**Slug:** `HUNTER_EMAIL_FINDER`

Tool to find the most likely email address for a person at a domain or company. Use when you have a person's name and a domain or company and need to infer their email. Results include a confidence score and status; treat emails with status 'accept_all' or 'risky' as lower reliability. Each call consumes API credits — avoid re-enriching the same contact.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | No | Target domain to search for the email (e.g., 'reddit.com'). Takes precedence over company if both are provided. |
| `company` | string | No | Company name to search for the email (e.g., 'Reddit'). Used if domain is not provided. |
| `full_name` | string | No | Person's full name. Required if first_name and last_name are not both provided. |
| `last_name` | string | No | 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 | No | 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 | No | Max duration of the request in seconds (range 320). Longer durations yield more accurate results. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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. Response may include statuses `accept_all` or `risky`, indicating uncertain deliverability; do not treat these as fully valid without explicit review. For bulk verification, honor `Retry-After` headers on HTTP 429 responses and use exponential backoff.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | The email address to verify. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Identifier of the custom attribute, must be a positive integer |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The unique identifier of the lead to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Identifier of the leads list. |
| `limit` | integer | No | A limit on the number of leads to return. Limit can range between 1 and 100. |
| `offset` | integer | No | The number of leads to skip. Use this parameter to fetch paginated results. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of campaigns to return. Range between 1 and 100. Defaults to 20. |
| `offset` | integer | No | Number of campaigns to skip for pagination. Defaults to 0. |
| `started` | boolean | No | 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 | No | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Filter leads by email address. |
| `limit` | integer | No | Number of leads to return (1-1000). Defaults to 20. |
| `query` | string | No | Search leads by first name, last name, or email. |
| `offset` | integer | No | Number of leads to skip for pagination (0-100000). Defaults to 0. |
| `company` | string | No | Filter leads by company name. |
| `twitter` | string | No | Filter leads by Twitter handle. |
| `website` | string | No | Filter leads by company website. |
| `position` | string | No | Filter leads by position. |
| `last_name` | string | No | Filter leads by last name. |
| `created_at` | string | No | Filter leads by creation date (ISO-8601 format). |
| `first_name` | string | No | Filter leads by first name. |
| `country_code` | string | No | Filter leads by country code (ISO 3166-1 alpha-2). |
| `linkedin_url` | string | No | Filter leads by LinkedIn profile URL. |
| `phone_number` | string | No | Filter leads by phone number. |
| `leads_list_id` | integer | No | Filter leads by a specific leads list ID. |
| `last_activity_at` | string | No | Filter leads by last activity date (ISO-8601 format). |
| `custom_attributes` | array | No | Filter leads by custom attributes. |
| `last_contacted_at` | string | No | Filter leads by last contacted date (ISO-8601 format). |
| `max_confidence_score` | integer | No | Filter leads with a maximum confidence score (0-100). |
| `min_confidence_score` | integer | No | Filter leads with a minimum confidence score (0-100). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | A limit on the number of leads lists to be returned. Range between 1 and 100. Defaults to 20. |
| `offset` | integer | No | The number of leads lists to skip for pagination. Defaults to 0. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### People Enrichment

**Slug:** `HUNTER_PEOPLE_ENRICHMENT`

Tool to find all information associated with an email address or LinkedIn profile including name, location, job title and social handles. Use when you need to enrich contact data with additional personal and professional details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | The email address for which to find associated information. At least one of email or linkedin_handle must be provided. |
| `clearbit_format` | boolean | No | When provided, formats response to match Clearbit's schema for consistency. |
| `linkedin_handle` | string | No | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Identifier of the custom attribute, must be a positive integer |
| `label` | string | Yes | The new label for the custom attribute. Must be unique. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Identifier of the lead to update, must be a positive integer |
| `email` | string | No | Email address of the lead |
| `notes` | string | No | Personal notes about the lead |
| `source` | string | No | Source where the lead was found |
| `company` | string | No | Company name of the lead |
| `twitter` | string | No | Twitter handle of the lead |
| `website` | string | No | Website or domain of the lead's company, e.g. 'reddit.com' |
| `position` | string | No | Job title of the lead |
| `last_name` | string | No | Last name of the lead |
| `first_name` | string | No | First name of the lead |
| `company_size` | string | No | Size category of the lead's company, e.g. '201-500 employees' |
| `country_code` | string | No | ISO 3166-1 alpha-2 country code of the lead |
| `linkedin_url` | string | No | LinkedIn profile URL of the lead |
| `phone_number` | string | No | Phone number of the lead |
| `leads_list_id` | integer | No | Identifier of a leads list to assign the lead to |
| `leads_list_ids` | array | No | Identifiers of multiple leads lists to assign the lead to |
| `company_industry` | string | No | Industry sector of the lead's company, e.g. 'Technology', 'Finance' |
| `confidence_score` | integer | No | Confidence score (0–100) that the email address is correct |
| `custom_attributes` | object | No | Map of custom attribute slugs to their values |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Identifier of the leads list to update, must be a positive integer |
| `name` | string | Yes | The new name for the leads list |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | The email address of the lead |
| `notes` | string | No | Internal notes about the lead |
| `source` | string | No | Source where the lead was found |
| `company` | string | No | Company name of the lead |
| `twitter` | string | No | Twitter handle of the lead (without @) |
| `website` | string | No | Domain of the lead's company, e.g., 'reddit.com' |
| `position` | string | No | Job title of the lead |
| `last_name` | string | No | Last name of the lead |
| `first_name` | string | No | First name of the lead |
| `company_size` | string | No | Size of the company, e.g., '201-500 employees' |
| `country_code` | string | No | ISO 3166-1 alpha-2 country code |
| `linkedin_url` | string | No | Public LinkedIn profile URL of the lead |
| `phone_number` | string | No | Phone number of the lead |
| `leads_list_id` | integer | No | ID of a single leads list. Defaults to the last list created if unset |
| `leads_list_ids` | array | No | IDs of multiple leads lists. Defaults to the last list created if unset |
| `company_industry` | string | No | Industry of the company, e.g., 'Technology', 'Finance' |
| `confidence_score` | integer | No | Probability (0–100) that the email is correct |
| `custom_attributes` | object | No | Map of custom attribute slug to value |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |