# Findymail

Findymail is a B2B email and phone data provider offering verified contact information, email verification, automated exports, and CRM enrichment to enhance sales prospecting and outreach efforts.

- **Category:** email
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 21
- **Triggers:** 0
- **Slug:** `FINDYMAIL`
- **Version:** 20260227_00

## Tools

### Add Excluded Domain

**Slug:** `FINDYMAIL_ADD_EXCLUDED_DOMAIN`

Tool to add domains to an exclusion list in Findymail. Use when you need to prevent email searches or verification for specific domains.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domains` | array | Yes | Array of domain names to add to the exclusion list |
| `excluded_domain_list_id` | integer | No | ID of the exclusion list to add domains to. If not provided, domains will be added to the default 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 |

### Create Exclusion List

**Slug:** `FINDYMAIL_CREATE_EXCLUSION_LIST`

Tool to create a new exclusion list for Intellimatch searches. Use when you need to filter out specific companies or contacts from search results.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the exclusion 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 |

### Create Contact List

**Slug:** `FINDYMAIL_CREATE_LIST`

Tool to create a new contact list. Use when you need to organize contacts into a named list before adding them.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the new contact 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 |

### Delete Exclusion List

**Slug:** `FINDYMAIL_DELETE_EXCLUSION_LIST`

Tool to permanently delete an exclusion list by its ID. Use when you need to remove an exclusion list from Intellimatch. This action is irreversible.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `exclusion_list_id` | integer | Yes | The unique numeric identifier of the exclusion list to delete. This action is irreversible. |

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

**Slug:** `FINDYMAIL_DELETE_LIST`

Permanently deletes a contact list by its ID. This action is irreversible and will also remove all contacts in the list. Returns 404 if the list does not exist.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The unique numeric identifier of the contact list to delete. Obtain this from FINDYMAIL_GET_CONTACT_LISTS or FINDYMAIL_CREATE_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 |

### Find Email by Name

**Slug:** `FINDYMAIL_FIND_EMAIL_BY_NAME`

Tool to find someone's email using their full name and company domain. Use when you have a person's name and domain and need their email address. Supports asynchronous search via webhook_url.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Person's full name |
| `domain` | string | Yes | Email domain (best) or company name |
| `webhook_url` | string | No | Webhook URL that will receive the result as callback. If provided, endpoint will process asynchronously. |

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

**Slug:** `FINDYMAIL_GET_CONTACT_LISTS`

Tool to retrieve all contact lists. Use when you need an overview of your existing Findymail lists.

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

**Slug:** `FINDYMAIL_GET_CREDITS`

Tool to check available API credits for your Findymail account. Use when you need to verify remaining credits before performing operations.

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

**Slug:** `FINDYMAIL_GET_CREDITS_SUMMARY`

Tool to retrieve credits usage summary report for the authenticated account. Use when you need to check credits consumption over time.

#### 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 Credits Team Summary

**Slug:** `FINDYMAIL_GET_CREDITS_TEAM_SUMMARY`

Tool to retrieve team credits usage summary report. Use when you need an overview of credit consumption across team members.

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

**Slug:** `FINDYMAIL_GET_EXCLUSION_LIST`

Tool to retrieve a specific exclusion list by ID. Use when you need details about a particular exclusion list.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `exclusion_list_id` | string | Yes | Unique identifier of the exclusion list 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 Intellimatch Data

**Slug:** `FINDYMAIL_GET_INTELLIMATCH_DATA`

Tool to retrieve data from an Intellimatch search. Use after initiating a search with POST /api/intellimatch/search and confirming completion with GET /api/intellimatch/status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hash` | string | Yes | The hash/search ID returned from the POST /api/intellimatch/search endpoint |

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

**Slug:** `FINDYMAIL_GET_INTELLIMATCH_STATUS`

Tool to check the status of an Intellimatch search job. Use when you need to verify if an Intellimatch search has completed after initiating it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hash` | string | Yes | The hash identifier of the Intellimatch search job (returned from POST /api/intellimatch/search) |

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

**Slug:** `FINDYMAIL_LIST_CONTACTS`

Tool to retrieve contacts from a specified list (paginated). Use after selecting a list to fetch its contacts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The ID of the contact list. Use 0 for "All contacts". |

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

**Slug:** `FINDYMAIL_LIST_EXCLUDED_DOMAINS`

Tool to retrieve all domains excluded from Intellimatch searches. Use when you need to view the current domain exclusion 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 |

### List Exclusion Lists

**Slug:** `FINDYMAIL_LIST_EXCLUSION_LISTS`

Tool to retrieve all exclusion lists for managing excluded websites from Intellimatch searches. Use when you need to view configured website exclusions.

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

### Remove Excluded Domain

**Slug:** `FINDYMAIL_REMOVE_EXCLUDED_DOMAIN`

Tool to remove domains from the exclusion list. Use when you need to stop excluding specific domains from email search results.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ids` | array | Yes | Array of domain IDs to remove from the exclusion list. Domain IDs can be obtained from the GET /api/intellimatch/domains endpoint. |

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

### Search Intellimatch

**Slug:** `FINDYMAIL_SEARCH_INTELLIMATCH`

Tool to find companies and contacts using natural language queries. Use when you need to build targeted lead lists automatically by describing your ideal customer profile in plain language.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return. If not specified, the API default will be used. |
| `query` | string | Yes | Natural language query describing the companies or contacts you're looking for (e.g., 'SaaS companies in San Francisco', 'CTOs at fintech startups in New York'). |
| `config` | object | No | Configuration options for Intellimatch search. |

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

**Slug:** `FINDYMAIL_UPDATE_EXCLUSION_LIST`

Tool to update an existing exclusion list. Use when you need to rename or modify an exclusion list's properties.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The new name for the exclusion list |
| `excludedDomainList_id` | string | Yes | The unique identifier of the exclusion list to update. Obtain this from listing exclusion lists. |

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

**Slug:** `FINDYMAIL_UPDATE_LIST`

Tool to update an existing contact list. Use when you need to rename a list or change its sharing settings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The unique numeric identifier of the contact list to update. Obtain this from FINDYMAIL_GET_CONTACT_LISTS or FINDYMAIL_CREATE_LIST. |
| `name` | string | Yes | Updated name for the contact list |
| `isShared` | boolean | Yes | Whether the list is shared with team members |

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

### Verify Email

**Slug:** `FINDYMAIL_VERIFY_EMAIL`

Tool to verify the deliverability of an email address. Use when you need to confirm an email can receive messages before outreach.

#### Input Parameters

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

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