NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Bouncer connects to a Nagent workspace with an API key. Once it is connected, agents can call 10 Bouncer actions, such as "Create Batch Request", "Create Toxicity List Job" and "Get Batch Results". 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 Bouncer, with input parameters and output schema.
BOUNCER_CHECK_TOXICITY_LIST_JOB_STATUSTool to check the status of a specific toxicity list job. Use after creating a toxicity list job to poll its status until completion.
Input parameters
Unique identifier of the toxicity list job to query
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
BOUNCER_CREATE_BATCH_REQUESTInitiates an asynchronous batch email verification request. Use when you have multiple emails to verify. Returns a batch ID for tracking - use BOUNCER_GET_BATCH_RESULTS to retrieve verification results after processing completes, or provide a callback URL.
Input parameters
List of email objects to verify in the batch
Webhook URL to receive a POST notification when batch processing completes. The callback will include the batchId and final status.
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
BOUNCER_CREATE_TOXICITY_LIST_JOBTool to create a toxicity analysis job for a list of email addresses. Use when you need to batch-process toxicity checks for multiple emails at once.
Input parameters
List of email addresses to analyze for toxicity
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
BOUNCER_DELETE_BATCH_REQUESTDeletes a batch email verification request and all associated emails and results. Use when you need to permanently remove batch data. This operation is idempotent - calling it multiple times on the same batch ID is safe and returns success. Data is automatically deleted by Bouncer after 60 days if not deleted manually.
Input parameters
The unique identifier of the batch to delete. This is the batchId returned when creating a batch request.
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
BOUNCER_DELETE_TOXICITY_LIST_JOBTool to delete a specific toxicity list job. Use when you need to remove a completed or unwanted toxicity analysis job after confirming its ID.
Input parameters
The unique identifier of the toxicity list job 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
BOUNCER_FINISH_BATCHTool to mark a batch verification process as finished early. Use when you need to stop batch processing before all emails are verified and reclaim credits for unprocessed emails. IMPORTANT: The batch must be in 'processing' status - cannot finish a batch that is 'queued' or already 'completed'.
Input parameters
Unique identifier of the batch to finish. Must be a batch currently in 'processing' status. Obtain this ID from the response of a Create Batch Request 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
BOUNCER_GET_BATCH_RESULTSTool to retrieve the results of a batch verification process. Use after submitting a batch to fetch all processed email verification outcomes. Note: If the batch is still processing, the API will return a 405 status indicating results are not yet available. Wait for the batch to complete before retrieving results.
Input parameters
Unique identifier of the batch to retrieve results for.
Filter which email statuses to include in results; one of: 'all', 'deliverable', 'risky', 'undeliverable', 'unknown'.
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
BOUNCER_GET_CREDITSTool to retrieve the current credit balance for the account. Use when you need to check available credits before performing verification operations.
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
BOUNCER_VERIFY_DOMAINTool to verify the validity and configuration of a domain. Use when you need to confirm the domain's MX records and catch-all behavior.
Input parameters
Domain name to verify (e.g., 'usebouncer.com').
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
BOUNCER_VERIFY_EMAILTool to verify a single email address in real-time. Use when validating email entry form inputs instantly.
Input parameters
Email address to verify in real-time.
Timeout for verification in seconds (default: 10).
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 10 Bouncer actions on Nagent, including "Create Batch Request", "Create Toxicity List Job" and "Get Batch Results". Create Batch Request: Initiates an asynchronous batch email verification request. Each action is listed on this page with its input parameters and its output.
Bouncer 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.
Create Batch Request takes 1 required input: items. It also takes 1 optional input: callback. It returns data, error and successful.