> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# NeverBounce

> NeverBounce provides email verification services to ensure the validity of email addresses, enhancing deliverability and reducing bounce rates.

![NeverBounce logo](https://mintcdn.com/composio-preview/9YPuzjEU4UlMnwGq/images/toolkits/neverbounce.svg?fit=max\&auto=format\&n=9YPuzjEU4UlMnwGq\&q=85\&s=aca13d3264378686ef9616fe6b49a114)

* **Category:** email
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 12
* **Triggers:** 0
* **Slug:** `NEVERBOUNCE`
* **Version:** 20261101\_00

## Tools

> [accordion] Get Account Info
>
> **Slug:** `NEVERBOUNCE_ACCOUNT_INFO`
>
> Tool to get account information including credits, job counts, and usage statistics. Use when retrieving NeverBounce account summary after authentication.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Confirm Proof of Email
>
> **Slug:** `NEVERBOUNCE_CONFIRM_POE`
>
> Confirm server-side whether an email submitted through the JavaScript widget was verified by NeverBounce, using its widget transaction details and result.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> The email address to verify
>
> **result** `string` *required*
>
> The verification result status from the widget
>
> **transaction\_id** `string` *required*
>
> Unique identifier for the verification transaction from the widget
>
> **confirmation\_token** `string` *required*
>
> Security token from the widget verification
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create NeverBounce Bulk Verification Job
>
> **Slug:** `NEVERBOUNCE_JOBS_CREATE`
>
> Tool to create a new bulk verification job with parsing, sampling, and callback options. Use for asynchronous list verification with advanced control.
>
> #### Input Parameters
>
> **input** `string` *required*
>
> When 'remote\_url', a URL to CSV or newline-delimited file. When 'supplied', an array of rows: lists or dicts of primitives.
>
> **filename** `string`
>
> Display name for the job in the dashboard.
>
> **auto\_parse** `boolean`
>
> Automatically parse the job after creation (default false).
>
> **auto\_start** `boolean`
>
> Automatically start verification after parsing (default false).
>
> **run\_sample** `boolean`
>
> Run a free sample analysis instead of the full job (default false).
>
> **callback\_url** `string`
>
> HTTP/HTTPS URL to receive lifecycle callbacks.
>
> **input\_location** `string ("remote_url" | "supplied")` *required*
>
> 'remote\_url' to reference a hosted file; 'supplied' to send inline data.
>
> **callback\_headers** `object`
>
> Custom headers for callback POST requests.
>
> **request\_meta\_data** `object`
>
> Settings for manual review behavior.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete NeverBounce Job
>
> **Slug:** `NEVERBOUNCE_JOBS_DELETE`
>
> Tool to permanently delete a job and its results. Use when you need to irreversibly remove a bulk verification job. This delete is irreversible.
>
> #### Input Parameters
>
> **job\_id** `integer` *required*
>
> Identifier of the job to permanently delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download Job Results (GET)
>
> **Slug:** `NEVERBOUNCE_JOBS_DOWNLOAD_GET`
>
> Tool to download job results as a CSV file via GET. Use after job completion to retrieve segmented or enriched CSV output.
>
> #### Input Parameters
>
> **tld** `integer ("0" | "1")`
>
> Append tld column
>
> **addr** `integer ("0" | "1")`
>
> Append addr column
>
> **fqdn** `integer ("0" | "1")`
>
> Append fqdn column
>
> **host** `integer ("0" | "1")`
>
> Append host column
>
> **alias** `integer ("0" | "1")`
>
> Append alias column
>
> **domain** `integer ("0" | "1")`
>
> Append domain column
>
> **job\_id** `integer` *required*
>
> ID of the finished job to download results for
>
> **valids** `integer ("0" | "1")`
>
> Include valid emails
>
> **network** `integer ("0" | "1")`
>
> Append network column
>
> **invalids** `integer ("0" | "1")`
>
> Include invalid emails
>
> **unknowns** `integer ("0" | "1")`
>
> Include unknown emails
>
> **catchalls** `integer ("0" | "1")`
>
> Include catchall emails
>
> **subdomain** `integer ("0" | "1")`
>
> Append subdomain column
>
> **bad\_syntax** `integer ("0" | "1")`
>
> Append bad\_syntax column
>
> **disposables** `integer ("0" | "1")`
>
> Include disposable emails
>
> **email\_status** `integer ("0" | "1")`
>
> Append email\_status column
>
> **has\_dns\_info** `integer ("0" | "1")`
>
> Append has\_dns\_info column
>
> **role\_account** `integer ("0" | "1")`
>
> Append role\_account column
>
> **line\_feed\_type** `string ("LINEFEED_0A0D" | "LINEFEED_0D0A" | "LINEFEED_0A" | "LINEFEED_0D")`
>
> CSV linefeed style. Default   . Options: LINEFEED\_0A0D (  ), LINEFEED\_0D0A ( ), LINEFEED\_0A ( ), LINEFEED\_0D ( )
>
> **free\_email\_host** `integer ("0" | "1")`
>
> Append free\_email\_host column
>
> **has\_mail\_server** `integer ("0" | "1")`
>
> Append has\_mail\_server column
>
> **only\_bad\_syntax** `integer ("0" | "1")`
>
> Return only bad-syntax records
>
> **only\_duplicates** `integer ("0" | "1")`
>
> Return only duplicate entries
>
> **email\_status\_int** `integer ("0" | "1")`
>
> Append email\_status\_int column
>
> **include\_duplicates** `integer ("0" | "1")`
>
> Include duplicate entries
>
> **binary\_operators\_type** `string ("BIN_1_0" | "BIN_Y_N" | "BIN_y_n" | "BIN_yes_no" | "BIN_Yes_No" | "BIN_true_false")`
>
> Representation for binary flags. Default is 1/0. Options: BIN\_1\_0, BIN\_Y\_N, BIN\_y\_n, BIN\_yes\_no, BIN\_Yes\_No, BIN\_true\_false
>
> **mail\_server\_reachable** `integer ("0" | "1")`
>
> Append mail\_server\_reachable column
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve Job Results
>
> **Slug:** `NEVERBOUNCE_JOBS_RESULTS`
>
> Tool to retrieve paginated results for a completed job, including original data and verification outcomes. Use after confirming job completion; avoid aggressive polling as repeated calls before completion risk rate limit errors.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to fetch (must be ≥1). Defaults to 1.
>
> **job\_id** `integer` *required*
>
> The ID of the completed job whose results you want to retrieve.
>
> **items\_per\_page** `integer`
>
> Number of items per page (1–1000). Defaults to 10.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Start NeverBounce Job
>
> **Slug:** `NEVERBOUNCE_JOBS_START`
>
> Start a parsed bulk verification job with auto-start disabled, optionally as a sample. Starting the list deducts credits, and processing cannot be stopped or restarted.
>
> #### Input Parameters
>
> **job\_id** `integer` *required*
>
> The ID of the job to start. Must reference an existing job created with auto\_start disabled.
>
> **run\_sample** `boolean`
>
> If true, only a sample of the list will be processed (default: false).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get bulk job status
>
> **Slug:** `NEVERBOUNCE_JOBS_STATUS`
>
> Tool to get the status and progress of a bulk verification job. Use when
>
> #### Input Parameters
>
> **job\_id** `string` *required*
>
> The unique identifier of the bulk verification job.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Parse NeverBounce Job
>
> **Slug:** `NEVERBOUNCE_PARSE_JOB`
>
> Tool to parse a job created with auto\_parse disabled. Use when you need to manually parse a job. Cannot reparse once parsed.
>
> #### Input Parameters
>
> **job\_id** `integer` *required*
>
> The ID of the job to parse. Must reference an existing job created with auto\_parse disabled.
>
> **auto\_start** `boolean`
>
> Should the job start processing immediately after it's parsed? (default: false)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search bulk verification jobs
>
> **Slug:** `NEVERBOUNCE_SEARCH_JOBS`
>
> Tool to search and list bulk verification jobs in your account with pagination and filtering. Use when retrieving jobs by id, filename, or status, or when listing all jobs with pagination.
>
> #### Input Parameters
>
> **page** `integer`
>
> The page to grab the jobs from (must be ≥1). Defaults to 1.
>
> **job\_id** `integer`
>
> Filter jobs based on its id.
>
> **filename** `string`
>
> Filter jobs based on the filename (exact match).
>
> **job\_status** `string`
>
> Filter jobs by the job status (e.g., 'complete', 'running', 'queued').
>
> **items\_per\_page** `integer`
>
> The number of jobs to display per page (1-1000). Defaults to 10.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] NeverBounce Single Check
>
> **Slug:** `NEVERBOUNCE_SINGLE_CHECK`
>
> Tool to verify a single email address and gather additional information. Use when you need real-time validation at the point of entry.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Email address to verify
>
> **timeout** `integer`
>
> Timeout in milliseconds for the verification attempt. Network latency not included in timeout calculation. Too low a value causes false negatives (premature timeouts reported as unverifiable); too high a value can stall workflows.
>
> **request\_meta\_data** `object`
>
> Additional request metadata to control verification behavior
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] JS Widget Send Event
>
> **Slug:** `NEVERBOUNCE_WIDGET_SEND_EVENT`
>
> Generate a JavaScript snippet to send a form.load or form.completion event through the NeverBounce widget API.
>
> #### Input Parameters
>
> **event** `string ("form.load" | "form.completion")` *required*
>
> The widget event to send. Supported values: 'form.load' (when the form appears) or 'form.completion' (when the form is successfully submitted).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
