Skip to main content
NeverBounce logo

​
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.
Categories: Sales · Enrichment · Sales Engagement · Auth: API Key · Actions: 2

​
Authentication

​
API Key Authentication

Authenticate using your NeverBounce API key
1

Step 1

Go to https://app.neverbounce.com and sign up or log in
2

Step 2

Open Settings and select the ‘API’ section
3

Step 3

Create a new API key or copy your existing one
4

Step 4

Paste the API key below

​
Required Credentials

FieldDescriptionRequiredFormat
NeverBounce API KeyYour NeverBounce API key from app.neverbounce.comYessecret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

​
Available Actions

​
Parameters

​
email
string
required
Email address to verify (e.g., john@example.com)

​
Response

{
  "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"
}

​
Response

{
  "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"
}

​
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.

Enrow

Findymail

Icypeas