NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Verifiedemail connects to a Nagent workspace with an API key. Once it is connected, agents can call 9 Verifiedemail actions, such as "Get 1-Click User Data", "Get Entitlements" and "Get Shared Credentials". 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 Verifiedemail, with input parameters and output schema.
VERIFIEDEMAIL_CHECK_CREDITSTool to retrieve the remaining verification credits. Call before VERIFIEDEMAIL_VERIFY_EMAIL operations—especially in bulk or repeated workflows—as VERIFIEDEMAIL_VERIFY_EMAIL fails immediately when credits are exhausted. Use after confirming account authentication to ensure sufficient credits before proceeding.
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
VERIFIEDEMAIL_CHECK_FILE_STATUSTool to check the status of a previously uploaded file. Use after uploading a file when polling for verification progress.
Input parameters
The ID of the file returned by the 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
VERIFIEDEMAIL_GET1_CLICK_USER_DATATool to retrieve data for a user who has completed a 1-Click Signup flow. Use after you have the identityUuid to fetch the verified user's full profile.
Input parameters
The unique identifier for the user, obtained from the SDK or as a URL parameter on the redirect URL
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
VERIFIEDEMAIL_GET_ENTITLEMENTSTool to retrieve information about available credits across different entitlement types. Use when you need to check credit availability before performing operations that consume credits.
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
VERIFIEDEMAIL_GET_SHARED_CREDENTIALSTool to retrieve a list of shared credential IDs. Use when you need to fetch all credentials shared to your account after authentication.
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
VERIFIEDEMAIL_LIST_DOWNLOADSTool to get a list of previously created download requests. Use when you need to retrieve information about download requests that have been created for verification results.
Input parameters
Number of items to return.
Number of items to offset the result set by.
Sort field for ordering results (e.g., 'dateAdded').
Sort order for results. Options: 'desc' (descending), 'asc' (ascending).
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
VERIFIEDEMAIL_LIST_LISTSTool to get all email lists in your account. Use when you need to retrieve and view all verification lists with optional pagination and sorting.
Input parameters
Number of items to return.
Number of items to offset the result set by.
Sort field for ordering the results.
Sort order for results (e.g., 'asc' for ascending, 'desc' for descending).
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
VERIFIEDEMAIL_POST1_CLICK_CREDENTIALS_UPDATETool to update 1-Click credentials. Use after obtaining a 1-Click session uuid when you need to update user-provided credential values in a non-hosted or trusted flow.
Input parameters
The unique identifier for the 1-Click session
An object containing the updated credential values. Keys are credential names and values are either simple strings or nested objects.
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
VERIFIEDEMAIL_VERIFY_EMAILTool to verify the deliverability and validity of an email address. Use when you need to confirm if an email can receive mail by checking server existence, mailbox status, and more. For bulk use, call VERIFIEDEMAIL_CHECK_CREDITS first — this tool fails if verification credits are exhausted.
Input parameters
The email address to verify.
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 9 Verifiedemail actions on Nagent, including "Get 1-Click User Data", "Get Entitlements" and "Get Shared Credentials". Get 1-Click User Data: Retrieve data for a user who has completed a 1-Click Signup flow. Each action is listed on this page with its input parameters and its output.
Verifiedemail 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.
Get 1-Click User Data takes 1 required input: identityUuid. It returns data, error and successful.