> ## Documentation Index
> Fetch the complete documentation index at: https://docs.modulex.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Hunter Integration for AI Agents & Workflows

> Find and verify professional email addresses using the Hunter.io API

{/* Self-hosted logo — build-time vendored from modulex.json / Iconify (see scripts/lib/logo.js). */}

<img src="https://mintcdn.com/modulexaillc/zKB2qsP6Q61VNLfB/logos/hunter.svg?fit=max&auto=format&n=zKB2qsP6Q61VNLfB&q=85&s=4d3c56c7e17e255677e8fec271b8dffd" alt="Hunter logo" width="72" height="72" data-path="logos/hunter.svg" />

## Overview

Add **Hunter** to any ModuleX agent or workflow. Find and verify professional email addresses, search domains for contacts, and manage leads using the Hunter.io API (`api.hunter.io/v2`).

<Info>
  **Categories**: Sales · Marketing & Sales · Lead Generation · Email · **Auth**: API Key · **Actions**: 13
</Info>

## Authentication

### API Key Authentication

Authenticate using your Hunter API key

<Steps>
  <Step title="Step 1">
    Go to [https://hunter.io](https://hunter.io) and sign in
  </Step>

  <Step title="Step 2">
    Navigate to your account API settings at [https://hunter.io/api-keys](https://hunter.io/api-keys)
  </Step>

  <Step title="Step 3">
    Copy your API key
  </Step>

  <Step title="Step 4">
    Paste the API key below
  </Step>
</Steps>

#### Required Credentials

| Field          | Description                                 | Required | Format                                     |
| -------------- | ------------------------------------------- | -------- | ------------------------------------------ |
| Hunter API Key | Your Hunter API key from hunter.io/api-keys | Yes      | `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |

## Available Actions

<AccordionGroup>
  <Accordion title="account_information — Get information about your Hunter account">
    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "email": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Email"
        },
        "first_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "First Name"
        },
        "last_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Last Name"
        },
        "plan_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Plan Name"
        },
        "plan_level": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Plan Level"
        },
        "reset_date": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Reset Date"
        },
        "team_id": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Team Id"
        },
        "calls_used": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Calls Used"
        },
        "calls_available": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Calls Available"
        }
      },
      "required": [
        "success"
      ],
      "title": "AccountInformationOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="combined_enrichment — Returns all the information associated with an email address and its domain name">
    ### Parameters

    <ResponseField name="email" type="string" required>
      The email address you want to find information about
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "data": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Data"
        }
      },
      "required": [
        "success"
      ],
      "title": "CombinedEnrichmentOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="create_lead — Create a new lead in your Hunter account">
    ### Parameters

    <ResponseField name="email" type="string" required>
      The email address of the lead
    </ResponseField>

    <ResponseField name="first_name" type="string">
      The first name of the lead
    </ResponseField>

    <ResponseField name="last_name" type="string">
      The last name of the lead
    </ResponseField>

    <ResponseField name="position" type="string">
      The job title of the lead
    </ResponseField>

    <ResponseField name="company" type="string">
      The name of the company the lead is working in
    </ResponseField>

    <ResponseField name="company_industry" type="string">
      The sector of the company. Allowed values: Animal, Art & Entertainment, Automotive, Beauty & Fitness, Books & Literature, Education & Career, Finance, Food & Drink, Game, Health, Hobby & Leisure, Home & Garden, Industry, Internet & Telecom, Law & Government, Manufacturing, News, Real Estate, Science, Retail, Sport, Technology, Travel
    </ResponseField>

    <ResponseField name="company_size" type="string">
      The size of the company the lead is working in
    </ResponseField>

    <ResponseField name="confidence_score" type="integer">
      Estimation of the probability the email address returned is correct, between 0 and 100
    </ResponseField>

    <ResponseField name="website" type="string">
      The domain name of the company
    </ResponseField>

    <ResponseField name="country_code" type="string">
      The country of the lead (ISO 3166-1 alpha-2 standard)
    </ResponseField>

    <ResponseField name="linkedin_url" type="string">
      The address of the public profile on LinkedIn
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      The phone number of the lead
    </ResponseField>

    <ResponseField name="twitter" type="string">
      The Twitter handle of the lead
    </ResponseField>

    <ResponseField name="notes" type="string">
      Some personal notes about the lead
    </ResponseField>

    <ResponseField name="source" type="string">
      The source where the lead has been found
    </ResponseField>

    <ResponseField name="leads_list_id" type="string">
      The identifier of the list the lead belongs to. If not specified, the lead is saved in the last list created
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "id": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "email": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Email"
        },
        "first_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "First Name"
        },
        "last_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Last Name"
        }
      },
      "required": [
        "success"
      ],
      "title": "CreateLeadOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="delete_lead — Delete an existing lead from your Hunter account">
    ### Parameters

    <ResponseField name="lead_id" type="string" required>
      The unique identifier of the lead
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        }
      },
      "required": [
        "success"
      ],
      "title": "DeleteLeadOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="domain_search — Search all the email addresses corresponding to one website or company">
    ### Parameters

    <ResponseField name="domain" type="string">
      Domain name from which you want to find the email addresses. For example, 'stripe.com'. Either domain or company must be provided
    </ResponseField>

    <ResponseField name="company" type="string">
      The company name from which you want to find the email addresses. For example, 'stripe'. Either domain or company must be provided
    </ResponseField>

    <ResponseField name="limit" type="integer" required>
      Specifies the max number of email addresses to return (Default: `100`)
    </ResponseField>

    <ResponseField name="type" type="string">
      Get only personal or generic email addresses. Allowed values: personal, generic
    </ResponseField>

    <ResponseField name="seniority" type="string">
      Get only email addresses for people with the selected seniority level(s). Comma-separated values: junior, senior, executive
    </ResponseField>

    <ResponseField name="department" type="string">
      Get only email addresses for people working in the selected department(s). Comma-separated values: executive, it, finance, management, sales, legal, support, hr, marketing, communication, education, design, health, operations
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "domain": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Domain"
        },
        "disposable": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Disposable"
        },
        "webmail": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Webmail"
        },
        "accept_all": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Accept All"
        },
        "pattern": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Pattern"
        },
        "organization": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Organization"
        },
        "emails": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Emails",
          "type": "array"
        },
        "total_results": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Total Results"
        }
      },
      "required": [
        "success"
      ],
      "title": "DomainSearchOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="email_count — Get the number of email addresses Hunter has for one domain or company">
    ### Parameters

    <ResponseField name="domain" type="string">
      Domain name from which you want to find the email addresses. For example, 'stripe.com'. Either domain or company must be provided
    </ResponseField>

    <ResponseField name="company" type="string">
      The company name from which you want to find the email addresses. For example, 'stripe'. Either domain or company must be provided
    </ResponseField>

    <ResponseField name="type" type="string">
      Get only personal or generic email addresses. Allowed values: personal, generic
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "total": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Total"
        },
        "personal_emails": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Personal Emails"
        },
        "generic_emails": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Generic Emails"
        },
        "department": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Department"
        }
      },
      "required": [
        "success"
      ],
      "title": "EmailCountOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="email_finder — Find the most likely email address from a domain name, a first name and a last name">
    ### Parameters

    <ResponseField name="domain" type="string">
      Domain name from which you want to find the email addresses. For example, 'stripe.com'. Either domain or company must be provided
    </ResponseField>

    <ResponseField name="company" type="string">
      The company name from which you want to find the email addresses. For example, 'stripe'. Either domain or company must be provided
    </ResponseField>

    <ResponseField name="first_name" type="string" required>
      The person's first name
    </ResponseField>

    <ResponseField name="last_name" type="string" required>
      The person's last name
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "email": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Email"
        },
        "first_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "First Name"
        },
        "last_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Last Name"
        },
        "score": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Score"
        },
        "domain": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Domain"
        },
        "accept_all": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Accept All"
        },
        "position": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Position"
        },
        "twitter": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Twitter"
        },
        "linkedin_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Linkedin Url"
        },
        "phone_number": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Phone Number"
        },
        "company": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company"
        },
        "sources": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Sources",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "EmailFinderOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="email_verifier — Check the deliverability of a given email address, verify if it has been found in Hunter's database, and return their sources">
    ### Parameters

    <ResponseField name="email" type="string" required>
      The email address you want to verify
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "status": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Status"
        },
        "result": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Result"
        },
        "score": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Score"
        },
        "email": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Email"
        },
        "regexp": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Regexp"
        },
        "gibberish": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Gibberish"
        },
        "disposable": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Disposable"
        },
        "webmail": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Webmail"
        },
        "mx_records": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Mx Records"
        },
        "smtp_server": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Smtp Server"
        },
        "smtp_check": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Smtp Check"
        },
        "accept_all": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Accept All"
        },
        "block": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Block"
        },
        "sources": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Sources",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "EmailVerifierOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="get_lead — Retrieve one of your leads by ID">
    ### Parameters

    <ResponseField name="lead_id" type="string" required>
      The unique identifier of the lead
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "id": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "email": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Email"
        },
        "first_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "First Name"
        },
        "last_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Last Name"
        },
        "position": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Position"
        },
        "company": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company"
        }
      },
      "required": [
        "success"
      ],
      "title": "GetLeadOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="get_leads_list — Retrieves all the fields of a leads list, including its leads">
    ### Parameters

    <ResponseField name="leads_list_id" type="string" required>
      Identifier of the leads list to retrieve
    </ResponseField>

    <ResponseField name="limit" type="integer" required>
      A limit on the number of leads to be returned. Limit can range between 1 and 100 (Default: `100`)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "id": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "leads": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Leads",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "GetLeadsListOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="list_leads — List all your leads with comprehensive filtering options">
    ### Parameters

    <ResponseField name="leads_list_id" type="string">
      Only returns the leads belonging to this list
    </ResponseField>

    <ResponseField name="email" type="string">
      Filter leads by email
    </ResponseField>

    <ResponseField name="first_name" type="string">
      Filter leads by first name
    </ResponseField>

    <ResponseField name="last_name" type="string">
      Filter leads by last name
    </ResponseField>

    <ResponseField name="position" type="string">
      Filter leads by position
    </ResponseField>

    <ResponseField name="company" type="string">
      Filter leads by company
    </ResponseField>

    <ResponseField name="industry" type="string">
      Filter leads by industry
    </ResponseField>

    <ResponseField name="website" type="string">
      Filter leads by website
    </ResponseField>

    <ResponseField name="country_code" type="string">
      Filter leads by country code (ISO 3166-1 alpha-2)
    </ResponseField>

    <ResponseField name="company_size" type="string">
      Filter leads by company size
    </ResponseField>

    <ResponseField name="source" type="string">
      Filter leads by source
    </ResponseField>

    <ResponseField name="twitter" type="string">
      Filter leads by Twitter handle
    </ResponseField>

    <ResponseField name="linkedin_url" type="string">
      Filter leads by LinkedIn URL
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      Filter leads by phone number
    </ResponseField>

    <ResponseField name="sync_status" type="string">
      Filter by synchronization status. Allowed values: pending, error, success
    </ResponseField>

    <ResponseField name="sending_status" type="string">
      Filter by sending status. Comma-separated values: clicked, opened, sent, pending, error, bounced, unsubscribed, replied
    </ResponseField>

    <ResponseField name="verification_status" type="string">
      Filter by verification status. Comma-separated values: accept\_all, disposable, invalid, unknown, valid, webmail, pending
    </ResponseField>

    <ResponseField name="last_activity_at" type="string">
      Filter by last activity. Allowed values: \* (any), \~ (unset)
    </ResponseField>

    <ResponseField name="last_contacted_at" type="string">
      Filter by last contact date. Allowed values: \* (any), \~ (unset)
    </ResponseField>

    <ResponseField name="query" type="string">
      Only returns leads with First Name, Last Name, or Email matching the query
    </ResponseField>

    <ResponseField name="limit" type="integer" required>
      A limit on the number of leads to be returned. Limit can range between 1 and 1000 (Default: `100`)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "leads": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Leads",
          "type": "array"
        },
        "total": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Total"
        }
      },
      "required": [
        "success"
      ],
      "title": "ListLeadsOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="list_leads_lists — List all your leads lists, sorted with the most recent first">
    ### Parameters

    <ResponseField name="limit" type="integer" required>
      A limit on the number of lists to be returned. Limit can range between 1 and 100 (Default: `100`)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "leads_lists": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Leads Lists",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "ListLeadsListsOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="update_lead — Update an existing lead in your Hunter account">
    ### Parameters

    <ResponseField name="lead_id" type="string" required>
      The unique identifier of the lead
    </ResponseField>

    <ResponseField name="email" type="string">
      The email address of the lead
    </ResponseField>

    <ResponseField name="first_name" type="string">
      The person's first name
    </ResponseField>

    <ResponseField name="last_name" type="string">
      The person's last name
    </ResponseField>

    <ResponseField name="position" type="string">
      The person's position in the company
    </ResponseField>

    <ResponseField name="company" type="string">
      The company name
    </ResponseField>

    <ResponseField name="website" type="string">
      The website URL of the company
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      The person's phone number
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        }
      },
      "required": [
        "success"
      ],
      "title": "UpdateLeadOutput",
      "type": "object"
    }
    ```
  </Accordion>
</AccordionGroup>

## Limits & Quotas

* **Free plan**: 25 searches and 50 verifications per month.
* **Paid plans**: Limits scale with plan tier (up to 30,000+ requests/month on Enterprise).
* **Rate limit**: 10 requests/second across all endpoints.
* **Error model**: Non-2xx responses and timeouts are caught and returned as `success=False` + `error` rather than raising.

## Related integrations

<CardGroup cols={3}>
  <Card title="Apollo.io" href="/integrations/tools/apollo-io" />

  <Card title="Brandfetch" href="/integrations/tools/brandfetch" />

  <Card title="Clay" href="/integrations/tools/clay" />
</CardGroup>

## Links

* [Hunter](https://hunter.io)