Findymail
Find and verify work emails.
SourcingAPI key21 endpoints
Runtime credentials
Connecting Findymail via OAuth or your own API key requires the following secret slots in your workspace:
- FINDYMAIL_API_KEY
Endpoints
| Operation | Method & path | Effect | Latency | Rate | Cost |
|---|---|---|---|---|---|
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. | POST /composio/findymail/findymail_add_excluded_domain | external_send | — | — | managed |
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. | POST /composio/findymail/findymail_create_exclusion_list | external_send | — | — | managed |
FINDYMAIL_CREATE_LIST Tool to create a new contact list. Use when you need to organize contacts into a named list before adding them. | POST /composio/findymail/findymail_create_list | external_send | — | — | managed |
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. | POST /composio/findymail/findymail_delete_exclusion_list | external_send | — | — | managed |
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. | POST /composio/findymail/findymail_delete_list | external_send | — | — | managed |
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. | GET /composio/findymail/findymail_find_email_by_name | none | — | — | managed |
FINDYMAIL_GET_CONTACT_LISTS Tool to retrieve all contact lists. Use when you need an overview of your existing Findymail lists. | GET /composio/findymail/findymail_get_contact_lists | none | — | — | managed |
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. | GET /composio/findymail/findymail_get_credits | none | — | — | managed |
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. | GET /composio/findymail/findymail_get_credits_summary | none | — | — | managed |
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. | GET /composio/findymail/findymail_get_credits_team_summary | none | — | — | managed |
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. | GET /composio/findymail/findymail_get_exclusion_list | none | — | — | managed |
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. | GET /composio/findymail/findymail_get_intellimatch_data | none | — | — | managed |
Showing 12 of 21 Findymail actions. Every action is in the provider catalog, and the CLI and MCP list them with their inputs.