NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Emaillistverify connects to a Nagent workspace with an API key. Once it is connected, agents can call 12 Emaillistverify actions, such as "Find Contact Email", "Get API File Info" and "Get Credits". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Emaillistverify, with input parameters and output schema.
EMAILLISTVERIFY_CHECK_BLACKLISTSTool to check an IP address (IPv4/IPv6) or domain against multiple DNS-based blacklists (DNSBLs) for spam or malicious activity. Use when you need to verify the reputation of an IP or domain. Rate limit: 10 requests/second.
Input parameters
The IP address (IPv4/IPv6) or domain to check against DNS-based blacklists (DNSBLs)
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
EMAILLISTVERIFY_CHECK_DISPOSABLETool to verify if an email domain is associated with temporary/disposable email addresses. Includes DNS record verification. Use when you need to validate if a domain is disposable before accepting email registrations.
Input parameters
The email domain to check for disposability
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
EMAILLISTVERIFY_DELETE_MAILLISTTool to delete a finished email list. Use when you need to remove a completed verification list. Only lists that have completed verification can be deleted.
Input parameters
ID of the finished email list to delete
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
EMAILLISTVERIFY_DOWNLOAD_MAILLISTTool to download a finished email list with verification results. Supports customizable columns (firstName, lastName, gender, result, etc.) and file format (csv/xlsx). Rate limit: 5 requests/second.
Input parameters
ID of the finished email list to download
Adds a column 'ELV ESP' displaying the Email Service Provider associated with the email's domain. Use 'true' or 'false'.
File format for the downloaded email list.
Filter rows by verification result. Comma-separated list of deliverability statuses (e.g., 'ok,email_disabled,antispam_system'). Defaults to all possible statuses.
Adds a column 'ELV Email' displaying the exact email used as input during verification. Use 'true' or 'false'.
Adds a column 'ELV Gender' with an estimation of the gender of the person associated with the email address. Use 'true' or 'false'.
Adds a column 'ELV Is Free' indicating if a free email account can be created using the same domain. Use 'true' or 'false'.
Adds a column 'ELV Is Role' to signify if the email pertains to a business role (e.g., info, support). Use 'true' or 'false'.
Adds a column 'ELV Result' displaying the verification result of the email. Use 'true' or 'false'.
Adds a column 'ELV Last Name' with an estimation of the last name of the person associated with the email address. Use 'true' or 'false'.
Adds a column 'ELV MX Server' displaying the MX server associated with the email's domain. Use 'true' or 'false'.
Includes all columns from the uploaded file that do not contain email information (e.g., Phone, Address). Use 'true' or 'false'.
Adds a column 'ELV First Name' with an estimation of the first name of the person associated with the email address. Use 'true' or 'false'.
Adds a column 'ELV Is No Reply' with values denoting whether the email's inbox is actively monitored. Use 'true' or 'false'.
If 'false', eliminates duplicate emails, retaining only the first occurrence. Use 'true' or 'false'.
Adds rows that do not contain precisely one email and cannot undergo verification. Use 'true' or 'false'.
Adds a column 'ELV Internal Result' displaying the internal verification result. Use 'true' or 'false'.
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
EMAILLISTVERIFY_FIND_CONTACTTool to search for a contact's business email address by name and company domain. Returns possible emails with confidence levels (high/medium/low/unknown). Rate limit: 5 requests/second. Credits: 5 (with name) or 10 (domain only).
Input parameters
Email domain of the contact's company (e.g., 'connelycorp.com'). This field is required.
Last name of the contact. Optional but improves accuracy and reduces credit cost (5 credits with name vs 10 without).
First name of the contact. Optional but improves accuracy and reduces credit cost (5 credits with name vs 10 without).
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
EMAILLISTVERIFY_GET_API_FILE_INFOTool to retrieve progress of an uploaded email list verification. Returns status (errored/waiting/progress/finished) with download URLs when complete.
Input parameters
ID of the successfully uploaded email 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
EMAILLISTVERIFY_GET_CREDITSTool to retrieve details about available on-demand and subscription credits. Use when you need to check credit balance before performing verifications. On-demand credits never expire, subscription credits are refreshed daily. Rate limit: 10 requests/second.
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
EMAILLISTVERIFY_GET_EMAIL_JOBTool to get the status of an asynchronous email verification job. Use when you need to check if a verification job has completed and retrieve its results. Rate limit: 100 requests per second.
Input parameters
ID of the email verification job 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
EMAILLISTVERIFY_GET_MAILLIST_PROGRESSTool to retrieve real-time progress updates for an uploaded email list verification. Shows status, completion percentage, and credit usage. Rate limit: 100 requests/second.
Input parameters
The unique identifier of the email list to retrieve progress for
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
EMAILLISTVERIFY_UPLOAD_EMAIL_LISTTool to upload an email list file for bulk verification. Accepts .csv, .txt, or .xlsx files (max 100MB, 1M rows). Returns an ID to query verification progress. Rate limit: 5 requests/second.
Input parameters
Quality level for email verification.
The email list file to upload (.csv.txt.xlsx). Max 100MB, 1M rows.
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
EMAILLISTVERIFY_VERIFY_SINGLE_EMAILTool to verify email deliverability status of a single email address. Returns a plain text status representing deliverability. Rate limit: 10 requests/second. Credits required: 1.
Input parameters
The email address that will 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
EMAILLISTVERIFY_VERIFY_SINGLE_EMAIL_DETAILEDTool to verify email deliverability with detailed metadata including MX server info, ESP, first/last name estimation, gender, and role detection. Use when you need comprehensive email validation beyond basic deliverability. Rate limit: 10 requests/second, requires 1 credit per verification.
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
Agents can call 12 Emaillistverify actions on Nagent, including "Find Contact Email", "Get API File Info" and "Get Credits". Find Contact Email: Search for a contact's business email address by name and company domain. Each action is listed on this page with its input parameters and its output.
Emaillistverify connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Find Contact Email takes 1 required input: domain. It also takes 2 optional inputs: lastName and firstName. It returns data, error and successful.