> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

![Findymail logo](https://mintcdn.com/composio-preview/r7CO9m4_UWMVFnU7/images/toolkits/findymail.svg?fit=max\&auto=format\&n=r7CO9m4_UWMVFnU7\&q=85\&s=8a376139858caedf77bfb106d943d00e)

* **Category:** people & contact data
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 21
* **Triggers:** 0
* **Slug:** `FINDYMAIL`
* **Version:** 20261101\_00

## Tools

> [accordion] Add Excluded Domain
>
> **Slug:** `FINDYMAIL_ADD_EXCLUDED_DOMAIN`
>
> Add domains to Findymail exclusions used by Intellimatch searches. Without a list identifier, domains are added as global exclusions. For batches over 50 domains, the first 50 are processed immediately and the rest are queued; up to 10,000 domains can be submitted.
>
> #### Input Parameters
>
> **domains** `array` *required*
>
> Array of domain names to add to the exclusion list
>
> **excluded\_domain\_list\_id** `integer`
>
> ID of the exclusion list to add domains to. If not provided, domains will be added to the default list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Exclusion List
>
> **Slug:** `FINDYMAIL_CREATE_EXCLUSION_LIST`
>
> Create a named exclusion list for the authenticated user to organize websites excluded from Intellimatch searches. The list name must be unique per user.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the exclusion list to create
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **name** `string` *required*
>
> Name of the new contact list
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Exclusion List
>
> **Slug:** `FINDYMAIL_DELETE_EXCLUSION_LIST`
>
> Delete an Intellimatch exclusion list by ID and all its associated domains. Only the list owner can delete it; the action is irreversible.
>
> #### Input Parameters
>
> **exclusion\_list\_id** `integer` *required*
>
> The unique numeric identifier of the exclusion list to delete. This action is irreversible.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **id** `integer` *required*
>
> The unique numeric identifier of the contact list to delete. Obtain this from FINDYMAIL\_GET\_CONTACT\_LISTS or FINDYMAIL\_CREATE\_LIST.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Email by Name
>
> **Slug:** `FINDYMAIL_FIND_EMAIL_BY_NAME`
>
> Find a person's email using their full name and company domain or company name. Supply a webhook URL to run the search asynchronously and receive the result by callback.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Person's full name
>
> **domain** `string` *required*
>
> Email domain (best) or company name
>
> **webhook\_url** `string`
>
> Webhook URL that will receive the result as callback. If provided, endpoint will process asynchronously.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Credits
>
> **Slug:** `FINDYMAIL_GET_CREDITS`
>
> Check the team's remaining Findymail credit balance before running operations. On usage-based plans, the response indicates whether the team still has capacity to run requests.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Credits Team Summary
>
> **Slug:** `FINDYMAIL_GET_CREDITS_TEAM_SUMMARY`
>
> Retrieve the team's credit usage summary for the default reporting period, including totals and usage by team member. Only the team owner can access this report.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Exclusion List
>
> **Slug:** `FINDYMAIL_GET_EXCLUSION_LIST`
>
> Retrieve metadata for an exclusion list by ID, without its domains. The list must be owned by the user or shared with their team.
>
> #### Input Parameters
>
> **exclusion\_list\_id** `string` *required*
>
> Unique identifier of the exclusion list to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Intellimatch Data
>
> **Slug:** `FINDYMAIL_GET_INTELLIMATCH_DATA`
>
> Retrieve the default first page of company data from a completed Intellimatch search by hash. The response exposes selected company fields and pagination metadata, not contact details.
>
> #### Input Parameters
>
> **hash** `string` *required*
>
> The hash/search ID returned from the POST /api/intellimatch/search endpoint
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **hash** `string` *required*
>
> The hash identifier of the Intellimatch search job (returned from POST /api/intellimatch/search)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **id** `integer` *required*
>
> The ID of the contact list. Use 0 for "All contacts".
>
> **start** `integer`
>
> The offset (starting record index) for pagination. Defaults to 0.
>
> **length** `integer`
>
> Number of records to return per page. Defaults to 10, max 100.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Excluded Domains
>
> **Slug:** `FINDYMAIL_LIST_EXCLUDED_DOMAINS`
>
> Retrieve a page of globally excluded domains for Intellimatch searches.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for paginated results (starts at 1). Defaults to 1.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove Excluded Domain
>
> **Slug:** `FINDYMAIL_REMOVE_EXCLUDED_DOMAIN`
>
> Remove excluded domains by ID from Intellimatch exclusion lists. Only domains the user has permission to delete are removed.
>
> #### Input Parameters
>
> **ids** `array` *required*
>
> Array of domain IDs to remove from the exclusion list. Domain IDs can be obtained from the GET /api/intellimatch/domains endpoint.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Intellimatch
>
> **Slug:** `FINDYMAIL_SEARCH_INTELLIMATCH`
>
> Start an Intellimatch company search using a natural-language query, optionally finding contacts and emails. The search returns a task hash for tracking progress and retrieving results, helping build targeted lead lists.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of results to return. If not specified, the API default will be used.
>
> **query** `string` *required*
>
> 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`
>
> Configuration options for Intellimatch search.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Exclusion List
>
> **Slug:** `FINDYMAIL_UPDATE_EXCLUSION_LIST`
>
> Rename an existing exclusion list. Only the list owner can update it.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The new name for the exclusion list
>
> **excluded\_domain\_list\_id** `string` *required*
>
> The unique identifier of the exclusion list to update. Obtain this from listing exclusion lists.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Contact List
>
> **Slug:** `FINDYMAIL_UPDATE_LIST`
>
> Update an existing Findymail contact list's name and team-sharing setting. Provide the list ID and both the updated name and sharing value.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The unique numeric identifier of the contact list to update. Obtain this from FINDYMAIL\_GET\_CONTACT\_LISTS or FINDYMAIL\_CREATE\_LIST.
>
> **name** `string` *required*
>
> Updated name for the contact list
>
> **isShared** `boolean` *required*
>
> Whether the list is shared with team members
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Verify Email
>
> **Slug:** `FINDYMAIL_VERIFY_EMAIL`
>
> Verify the deliverability of an email address before outreach. The result indicates whether the address is verified and may include its email provider.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> The email address to be verified.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
