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

# Findymail

> Connect Findymail to your Atako agents — 15 read and 2 write actions.

Let your agents find and verify professional e-mail addresses with Findymail: look up a person's e-mail from a name or a LinkedIn profile, verify an address, find employees, company data and phone numbers, inspect a company's tech stack, look for lookalike companies, manage contact lists and read signals.

## Connection

* **Authentication**: API key (Findymail API token).

> [!NOTE]
>
> In Findymail, open the left sidebar → ADVANCED → API, then go to app.findymail.com/user/api-tokens and click Create. Select the token text and copy it now (there is no copy button) — it is shown only once. A token has no scopes: it carries all the account rights and spends its credits.
>
> See [Findymail's documentation](https://app.findymail.com/docs/).

## Read actions (15)

| Action | Description |
| - | - |
| `find_email_by_name` | Find a person's professional e-mail from their full name and a company domain or name (spends 1 finder credit only if a verified e-mail is found). Arguments: name (string, REQUIRED), domain (string, REQUIRED). |
| `find_email_from_linkedin` | Find a person's professional e-mail from their LinkedIn business profile URL (spends 1 finder credit only if a verified e-mail is found). Argument: linkedin\_url (string, REQUIRED). |
| `find_employees` | Find employees of a company by website and job titles — this endpoint does NOT return an e-mail (spends 1 finder credit per contact found). Arguments: website (string, REQUIRED), job\_titles (string\[], REQUIRED, 1 to 10), count (integer, 1 to 3, optional, default 1). |
| `find_lookalike_companies` | Find companies similar to a seed domain, optionally restricted to the same country or the same size, and excluding known companies (spends 1 finder credit per 10 results returned, rounded up). Arguments: seed (string, REQUIRED), same\_country (boolean), same\_size (boolean), limit (integer 1 to 10000, default 100), exclusion\_list\_ids (integer\[], optional). |
| `find_phone` | Find a person's phone number from their LinkedIn profile URL — US numbers only, and no result is returned for EU citizens for legal reasons (spends 10 finder credits if a phone is found). Argument: linkedin\_url (string, REQUIRED). |
| `get_company` | Get company information (name, domain, size, industry, LinkedIn, description) from a LinkedIn URL, a domain or a name (spends 1 finder credit when company data is found). Arguments: at least one of linkedin\_url, domain, name (strings). |
| `get_credits` | Get the account's remaining finder and verifier credits — a read, free. |
| `get_saved_contacts` | Get the contacts saved in a list, or all contacts when id is 0 — a read, free. Argument: id (integer, REQUIRED, the list id or 0 for "All contacts"). |
| `get_signal` | Get a single signal with its contact, company and monitors — a read, free. Argument: id (integer, REQUIRED). |
| `list_contact_lists` | List the account's contact lists — a read, free. |
| `list_signals` | List the signals detected by the account's monitors with their contact, company and monitor, filtered by type, monitor or date range — a read, free. Arguments: signal\_type, monitor\_id, date\_from, date\_to, relevance\_scores, page, per\_page (all optional). |
| `lookup_technologies` | Look up the technology stack of a company by its domain, optionally filtered by technology names (spends 1 finder credit when technologies are found, free when none). Arguments: domain (string, REQUIRED), technologies (string\[], optional filter, max 100). |
| `reverse_email_lookup` | Find a LinkedIn business profile from an e-mail address (spends 1 finder credit if a profile is found, 2 if profile enrichment is enabled). Arguments: email (string, REQUIRED), with\_profile (boolean, optional, default false). |
| `search_technologies` | Search the technology catalog by name and get up to 25 matches — a read, free, rate-limited to 10 requests per minute. Argument: q (string, REQUIRED, at least 2 chars). |
| `verify_email` | Verify an e-mail address — find out whether it is valid (spends 1 verifier credit on every attempt, valid or not). Argument: email (string, REQUIRED). |

## Write actions (2)

| Action | Description |
| - | - |
| `create_contact_list` | Create a new contact list. Argument: name (string, REQUIRED, max 255 chars). |
| `update_contact_list` | Update a contact list's name and whether it is shared with the team. Arguments: id (integer, REQUIRED), name (string, REQUIRED, max 255 chars), isShared (boolean, REQUIRED). |

## Permissions

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

***

*Last reviewed against the provider API: October 2026.*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.