Emailable connects to a Nagent workspace with an API key. Once it is connected, agents can call 5 Emailable actions, such as "Get Account Info", "Get Batch Status" and "Build OAuth Authorization URL". 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 Emailable, with input parameters and output schema.
EMAILABLE_GET_ACCOUNT_INFOTool to retrieve account information including owner email and available credits. Use when you need to confirm account status before sending 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
EMAILABLE_GET_BATCH_STATUSTool to get the status and results of a batch verification job. Use after submitting a batch to check its progress.
Input parameters
The unique identifier for the batch verification job returned when creating a batch.
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
EMAILABLE_O_AUTH_AUTHORIZEBuild an OAuth 2.0 authorization URL for the Emailable authorization code flow. Returns a URL to redirect users to for authorization. Upon successful authorization, users are redirected to your redirect_uri with an authorization code (valid for 10 minutes) that can be exchanged for access tokens.
Input parameters
An arbitrary string to maintain state between the request and callback. The server returns it unchanged. Used to prevent CSRF attacks.
Your OAuth App's client ID from the Emailable developer dashboard
The registered redirect URI of your OAuth App where the authorization code will be sent
Must be 'code' for authorization code flow. This is the only supported value.
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
EMAILABLE_VERIFY_BATCH_EMAILSSubmit a batch of email addresses for asynchronous verification. Returns a batch ID immediately. Use this for bulk email validation (2 to 50,000 emails). For single emails, use EMAILABLE_VERIFY_EMAIL instead. The batch is processed asynchronously - use EMAILABLE_GET_BATCH_STATUS with the returned batch ID to check progress and retrieve verification results.
Input parameters
List of email addresses to verify. Must contain at least 2 emails (use EMAILABLE_VERIFY_EMAIL for single emails). Maximum 50,000 emails per batch.
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
EMAILABLE_VERIFY_EMAILTool to verify a single email address and return detailed results. Use when you need to check email deliverability and risk.
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 5 Emailable actions on Nagent, including "Get Account Info", "Get Batch Status" and "Build OAuth Authorization URL". Get Account Info: Retrieve account information including owner email and available credits. Each action is listed on this page with its input parameters and its output.
Emailable 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.
It returns data, error and successful.