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

# Hunter

> Connect Hunter to your Atako agents — 9 read and 4 write actions.

Let your agents find and verify professional email addresses, search domains for contacts, and manage leads and email campaigns via the Hunter API.

## Connection

* **Authentication**: API key.

<Note>
  Sign in at hunter.io → click your profile icon (top right) → API → API key. Copy the key. The free plan includes 25 searches and 50 verifications per month.

  See [Hunter's documentation](https://hunter.io/api-keys).
</Note>

## Read actions (9)

| Action             | Description                                                                                                                                                         |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `domain_search`    | Search all email addresses found for a domain. Provide either "domain" or "company" (domain takes precedence if both given).                                        |
| `email_count`      | Get the number of email addresses found for a domain. Provide either "domain" or "company".                                                                         |
| `email_finder`     | Find the most likely email address for a person at a given domain. Provide "domain" or "company" plus at least one of "first\_name", "last\_name", or "full\_name". |
| `email_verifier`   | Verify the deliverability and status of an email address.                                                                                                           |
| `get_account`      | Get account information (plan, usage, API calls remaining).                                                                                                         |
| `get_lead`         | Retrieve a single lead by its ID.                                                                                                                                   |
| `list_campaigns`   | List all email campaigns in your Hunter account.                                                                                                                    |
| `list_leads`       | List leads in your Hunter account, optionally filtered by list, email or company.                                                                                   |
| `list_leads_lists` | List all leads lists in your Hunter account.                                                                                                                        |

## Write actions (4)

| Action                    | Description                                                                                                                                                                                                                  |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `add_campaign_recipients` | Add recipients to an email campaign. Pass "emails" (array of email strings) or "lead\_ids" (array of integer IDs). Do not send both.                                                                                         |
| `create_lead`             | Create a new lead. All fields are strings unless noted: first\_name (string), last\_name (string), email (string), position (string), company (string), website (string), phone\_number (string), leads\_list\_id (integer). |
| `create_leads_list`       | Create a new leads list. "name" is a string.                                                                                                                                                                                 |
| `update_lead`             | Update an existing lead by ID. Same fields as create\_lead (all optional except id).                                                                                                                                         |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.