NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Clearout connects to a Nagent workspace with an API key. Once it is connected, agents can call 21 Clearout actions, such as "Find Domain MX Records", "Find Person via LinkedIn URL" and "Autocomplete Company to Domain". 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 Clearout, with input parameters and output schema.
CLEAROUT_AUTOCOMPLETE_COMPANY_TO_DOMAINTool to autocomplete company names to probable domains with confidence scores. Use after obtaining a company name or URL to get suggestions.
Input parameters
Company name, domain, or website URL to autocomplete domains. Examples: 'amazon', 'amazon.com', 'https://amazon.com/about'.
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
CLEAROUT_BUSINESS_ACCOUNT_VERIFYTool to check if an email belongs to a business/work account. Use when validating corporate emails before onboarding.
Input parameters
An email address to verify for a business/work account
Request wait time in milliseconds; max 110000; default 90000
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
CLEAROUT_CATCH_ALL_VERIFYTool to check if an email domain is catch-all. Use after confirming email validity.
Input parameters
Email address to verify for catch-all
Timeout in milliseconds; maximum 110000; default 90000
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
CLEAROUT_DISPOSABLE_VERIFYTool to check if an email is from a disposable provider. Use after acquiring an email address.
Input parameters
Email address to verify for disposability.
Request wait time in milliseconds; maximum 110000; default is 90000 if omitted.
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
CLEAROUT_DOMAIN_FIND_MXTool to retrieve MX records for a domain in priority order. Use when you need to find a domain's mail servers (e.g., for email routing setup).
Input parameters
Domain to resolve MX records for
Maximum wait time for MX resolution in milliseconds (default 90000, max 110000)
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
CLEAROUT_DOMAIN_FIND_WHOISTool to fetch WHOIS record for a domain. Use when you need WHOIS data for a domain.
Input parameters
Domain to fetch WHOIS information for, must be a non-empty string.
Wait time in milliseconds (max 110000; default 90000).
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
CLEAROUT_EMAIL_FINDER_BULKTool to upload a CSV or XLSX contacts file for bulk email finding. Use when you need to find emails for a list of contacts in bulk.
Input parameters
Contacts file to upload for bulk email finding. Supported extensions:.csv,.xlsx. The CSV/XLSX file must contain columns for person's name and company domain or company name.
Whether to allow uploading a file with the same name and size as a recent upload. Defaults to 'false'. Set to 'true' to override duplicates.
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
CLEAROUT_EMAIL_FINDER_BULK_CANCELTool to cancel a running bulk email finder job. Use when you need to stop an in-progress list scan before completion.
Input parameters
The unique 24-character hexadecimal identifier for the bulk email finder job to cancel. This ID is returned when you create a bulk email finder job using the EMAIL_FINDER_BULK action.
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
CLEAROUT_EMAIL_FINDER_BULK_RESULT_DOWNLOADTool to generate a bulk email finder result download URL. Use after confirming bulk job completion to retrieve the result file link.
Input parameters
The List ID returned by the bulk email finder response used to retrieve the result file.
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
CLEAROUT_EMAIL_VERIFY_BULKTool to upload a CSV or XLSX file for bulk email verification. Use when you have a list of emails to verify in bulk.
Input parameters
Email list file to verify in bulk. Supported extensions: .csv, .xlsx.
Optimization mode for bulk verification. 'highest_accuracy' prioritizes precision; 'fastest_turnaround' prioritizes speed. Defaults to 'highest_accuracy'.
Whether to allow uploading a file that matches a recent upload (same name & size). Defaults to 'false'. Set to 'true' to override duplicates.
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
CLEAROUT_EMAIL_VERIFY_BULK_CANCELCancel an in-progress bulk email verification job. Use this to stop a running verification before it completes, saving credits for unprocessed emails. The job must be in a cancellable state (not already completed or cancelled). Returns error code 1029 if list doesn't exist, or error code 1116 if the list is not in a cancellable stage.
Input parameters
The 24-character MongoDB ObjectId (hex string) for the bulk email verification job to cancel. Obtain this from the response of the EMAIL_VERIFY_BULK action.
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
CLEAROUT_EMAIL_VERIFY_BULK_PROGRESS_STATUSTool to retrieve progress for a bulk email verification job. Use after initiating a bulk verification to poll its state and percent complete.
Input parameters
Identifier of the bulk email verification job returned by the bulk upload 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
CLEAROUT_EMAIL_VERIFY_BULK_RESULT_DOWNLOADTool to obtain a temporary URL for bulk email verification results. Use after completing a bulk verification job to download the results file.
Input parameters
The unique identifier (24-character hex string) of a bulk email verification list, returned by the CLEAROUT_EMAIL_VERIFY_BULK action. The verification job must be completed before downloading results.
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
CLEAROUT_EMAIL_VERIFY_GET_CREDITSTool to fetch available email verification credits. Use when checking remaining credits before performing email verifications.
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
CLEAROUT_EMAIL_VERIFY_INSTANTTool to instantly verify a single email address. Use when you need real-time validation before processing an email.
Input parameters
Email address to verify.
Request wait time in milliseconds; default is 130000, max is 180000.
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
CLEAROUT_FREE_ACCOUNT_VERIFYTool to detect if an email is from a free email service provider. Use after confirming the email format.
Input parameters
An email address to verify for a free email service provider
Request wait time in milliseconds; max 110000; default 90000
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
CLEAROUT_GIBBERISH_ACCOUNT_VERIFYTool to verify if an email address is gibberish. Use when filtering out nonsensical or invalid-looking emails.
Input parameters
Email address to verify for gibberish.
Request wait time in milliseconds; default is 90000; maximum is 110000.
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
CLEAROUT_REVERSE_LOOKUP_FIND_COMPANY_VIA_DOMAINFind company information (name, logo, LinkedIn URL, address) by looking up its domain name. Returns company profile data if found, or an error with code 5025 if no profile exists for the domain.
Input parameters
The company's domain name (e.g., 'amazon.com', 'microsoft.com'). Do not include 'https://' or 'www.' prefix - just the bare domain.
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
CLEAROUT_REVERSE_LOOKUP_FIND_PERSON_VIA_EMAILTool to retrieve a person’s profile from an email address. Use when you want to enrich a valid email with associated person details.
Input parameters
Email address to look up the person profile
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
CLEAROUT_REVERSE_LOOKUP_FIND_PERSON_VIA_LINKED_INTool to discover person information via a LinkedIn profile URL. Use when you need to retrieve person’s profile details from a LinkedIn URL.
Input parameters
LinkedIn profile URL of the person (e.g., https://www.linkedin.com/in/williamhgates/).
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
CLEAROUT_ROLE_ACCOUNT_VERIFYTool to determine if an email is a role-based account. Use when identifying group mailboxes (e.g., support@) before sending targeted communications.
Input parameters
Email address to verify (e.g., support@company.com).
Optional timeout in milliseconds; default is 90000, max is 110000.
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 21 Clearout actions on Nagent, including "Find Domain MX Records", "Find Person via LinkedIn URL" and "Autocomplete Company to Domain". Find Domain MX Records: Retrieve MX records for a domain in priority order. Each action is listed on this page with its input parameters and its output.
Clearout 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 Domain MX Records takes 1 required input: domain. It also takes 1 optional input: timeout. It returns data, error and successful.