> ## Documentation Index
> Fetch the complete documentation index at: https://docs.modulex.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# NeverBounce Integration for AI Agents & Workflows

> Integrate NeverBounce to verify email deliverability in real time — classify addresses as valid, invalid, catch-all, disposable, or unknown — and check your remaining verification credits.

{/* Self-hosted logo — build-time vendored from modulex.json / Iconify (see scripts/lib/logo.js). */}

<img src="https://mintcdn.com/modulexaillc/df8MOr-hXotYLTh5/logos/placeholder.svg?fit=max&auto=format&n=df8MOr-hXotYLTh5&q=85&s=a4046f9cd6d738c81259050e9833913c" alt="NeverBounce logo" width="72" height="72" data-path="logos/placeholder.svg" />

## Overview

Add **NeverBounce** to any ModuleX agent or workflow. Real-time email verification and account credit lookup against the NeverBounce v4 REST API (`api.neverbounce.com/v4`). Classifies an address as valid, invalid, catch-all, disposable, or unknown and surfaces role-account and free-provider flags.

<Info>
  **Categories**: Sales · Enrichment · Sales Engagement · **Auth**: API Key · **Actions**: 2
</Info>

## Authentication

### API Key Authentication

Authenticate using your NeverBounce API key

<Steps>
  <Step title="Step 1">
    Go to [https://app.neverbounce.com](https://app.neverbounce.com) and sign up or log in
  </Step>

  <Step title="Step 2">
    Open Settings and select the 'API' section
  </Step>

  <Step title="Step 3">
    Create a new API key or copy your existing one
  </Step>

  <Step title="Step 4">
    Paste the API key below
  </Step>
</Steps>

#### Required Credentials

| Field               | Description                                       | Required | Format                                    |
| ------------------- | ------------------------------------------------- | -------- | ----------------------------------------- |
| NeverBounce API Key | Your NeverBounce API key from app.neverbounce.com | Yes      | `secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |

## Available Actions

<AccordionGroup>
  <Accordion title="verify_email — Verify the deliverability of an email address. Classifies the address as valid, invalid, catch_all, disposable, or unknown and surfaces role-account and free-provider flags. Uses one verification credit.">
    ### Parameters

    <ResponseField name="email" type="string" required>
      Email address to verify (e.g., [john@example.com](mailto:john@example.com))
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "description": "Result of verifying a single email address.",
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "email": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Email"
        },
        "status": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Status"
        },
        "deliverable": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Deliverable"
        },
        "role_account": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Role Account"
        },
        "free_email": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Free Email"
        },
        "did_you_mean": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Did You Mean"
        },
        "flags": {
          "items": {
            "type": "string"
          },
          "title": "Flags",
          "type": "array"
        },
        "result": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Result"
        }
      },
      "required": [
        "success"
      ],
      "title": "VerifyEmailOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="get_credits — Retrieve the remaining paid and free verification credits for the account.">
    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "description": "Remaining verification credits for the account.",
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "credits": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Credits"
        },
        "free_credits": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Free Credits"
        }
      },
      "required": [
        "success"
      ],
      "title": "GetCreditsOutput",
      "type": "object"
    }
    ```
  </Accordion>
</AccordionGroup>

## Limits & Quotas

* **Rate limit**: \~60 requests/min on standard plans.
* **Credits**: each `verify_email` call consumes one verification
  credit; `get_credits` is free and does not consume credits.
* **Error model**: the v4 API returns HTTP 200 even for API-level
  failures and signals the outcome via the response envelope's
  `status` field. A non-`"success"` status, a non-2xx HTTP response,
  or a timeout is caught and returned as `success=False` + `error`
  rather than raising. Plan for retries on the agent side based on the
  error string.

## Related integrations

<CardGroup cols={3}>
  <Card title="Enrow" href="/integrations/tools/enrow" />

  <Card title="Findymail" href="/integrations/tools/findymail" />

  <Card title="Icypeas" href="/integrations/tools/icypeas" />
</CardGroup>

## Links

* [NeverBounce](https://www.neverbounce.com)