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 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. On Nagent, Findymail is exposed as a fully-configurable email integration that any agent can call — 21 actions, and API key authentication. No code is required to wire Findymail into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Findymail to automate the kinds of tasks email teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Findymail into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Findymail, with input parameters and output schema. Drop these into any step of an agent built in Helix.
FINDYMAIL_ADD_EXCLUDED_DOMAINTool to add domains to an exclusion list in Findymail. Use when you need to prevent email searches or verification for specific domains.
Input parameters
Array of domain names to add to the exclusion list
ID of the exclusion list to add domains to. If not provided, domains will be added to the default list.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FINDYMAIL_CREATE_EXCLUSION_LISTTool 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
Name of the exclusion list to create
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FINDYMAIL_CREATE_LISTTool to create a new contact list. Use when you need to organize contacts into a named list before adding them.
Input parameters
Name of the new contact list
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FINDYMAIL_DELETE_EXCLUSION_LISTTool 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
The unique numeric identifier of the exclusion list to delete. This action is irreversible.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FINDYMAIL_DELETE_LISTPermanently 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
The unique numeric identifier of the contact list to delete. Obtain this from FINDYMAIL_GET_CONTACT_LISTS or FINDYMAIL_CREATE_LIST.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FINDYMAIL_FIND_EMAIL_BY_NAMETool 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
Person's full name
Email domain (best) or company name
Webhook URL that will receive the result as callback. If provided, endpoint will process asynchronously.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FINDYMAIL_GET_CONTACT_LISTSTool to retrieve all contact lists. Use when you need an overview of your existing Findymail lists.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FINDYMAIL_GET_CREDITSTool to check available API credits for your Findymail account. Use when you need to verify remaining credits before performing operations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FINDYMAIL_GET_CREDITS_SUMMARYTool to retrieve credits usage summary report for the authenticated account. Use when you need to check credits consumption over time.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FINDYMAIL_GET_CREDITS_TEAM_SUMMARYTool to retrieve team credits usage summary report. Use when you need an overview of credit consumption across team members.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FINDYMAIL_GET_EXCLUSION_LISTTool to retrieve a specific exclusion list by ID. Use when you need details about a particular exclusion list.
Input parameters
Unique identifier of the exclusion list to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FINDYMAIL_GET_INTELLIMATCH_DATATool 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
The hash/search ID returned from the POST /api/intellimatch/search endpoint
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FINDYMAIL_GET_INTELLIMATCH_STATUSTool 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
The hash identifier of the Intellimatch search job (returned from POST /api/intellimatch/search)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FINDYMAIL_LIST_CONTACTSTool to retrieve contacts from a specified list (paginated). Use after selecting a list to fetch its contacts.
Input parameters
The ID of the contact list. Use 0 for "All contacts".
The offset (starting record index) for pagination. Defaults to 0.
Number of records to return per page. Defaults to 10, max 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FINDYMAIL_LIST_EXCLUDED_DOMAINSTool to retrieve domains excluded from Intellimatch searches. Use when you need to view the current domain exclusion list.
Input parameters
Page number for paginated results (starts at 1). Defaults to 1.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FINDYMAIL_LIST_EXCLUSION_LISTSTool to retrieve all exclusion lists for managing excluded websites from Intellimatch searches. Use when you need to view configured website exclusions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FINDYMAIL_REMOVE_EXCLUDED_DOMAINTool to remove domains from the exclusion list. Use when you need to stop excluding specific domains from email search results.
Input parameters
Array of domain IDs to remove from the exclusion list. Domain IDs can be obtained from the GET /api/intellimatch/domains endpoint.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FINDYMAIL_SEARCH_INTELLIMATCHTool 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
Maximum number of results to return. If not specified, the API default will be used.
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').
Configuration options for Intellimatch search.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FINDYMAIL_UPDATE_EXCLUSION_LISTTool to update an existing exclusion list. Use when you need to rename or modify an exclusion list's properties.
Input parameters
The new name for the exclusion list
The unique identifier of the exclusion list to update. Obtain this from listing exclusion lists.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FINDYMAIL_UPDATE_LISTTool to update an existing contact list. Use when you need to rename a list or change its sharing settings.
Input parameters
The unique numeric identifier of the contact list to update. Obtain this from FINDYMAIL_GET_CONTACT_LISTS or FINDYMAIL_CREATE_LIST.
Updated name for the contact list
Whether the list is shared with team members
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FINDYMAIL_VERIFY_EMAILTool to verify the deliverability of an email address. Use when you need to confirm an email can receive messages before outreach.
Input parameters
The email address to be verified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 51 agents privately built on Nagent that already use Findymail.
Build on Nagent
Connect Findymail to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Findymail, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Findymail is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Findymail is connected, you configure its 21 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Findymail steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Findymail event fires, the agent kicks off automatically.
Every Findymail action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Findymail ships with 21 pre-built email actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Findymail together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Findymail-based workflows tailored to your business.