Mails.so connects to a Nagent workspace with an API key. Once it is connected, agents can call 3 Mails.so actions: "Retrieve Batch Results", "Validate Bulk Emails" and "Validate Single Email". 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 Mails.so, with input parameters and output schema.
MAILS_SO_RETRIEVE_BATCH_RESULTSTool to retrieve results of a bulk validation job. Use after submitting a batch and you have its ID.
Input parameters
Unique identifier for the batch validation job
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
MAILS_SO_VALIDATE_BULK_EMAILSTool to validate multiple email addresses in bulk. Use when you need to confirm deliverability of a list of emails at once.
Input parameters
List of 1–1000 email addresses to validate
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
MAILS_SO_VALIDATE_SINGLE_EMAILTool to validate a single email address. Use when you need to check deliverability and quality details before sending an email.
Input parameters
The email address to validate.
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 3 Mails.so actions on Nagent: "Retrieve Batch Results", "Validate Bulk Emails" and "Validate Single Email". Retrieve Batch Results: Retrieve results of a bulk validation job. Each action is listed on this page with its input parameters and its output.
Mails.so 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.
Retrieve Batch Results takes 1 required input: id. It returns data, error and successful.