Skip to main content
ZeroBounce logo

​
Overview

Add ZeroBounce to any ModuleX agent or workflow. Real-time email validation and deliverability checks against the ZeroBounce v2 REST API (api.zerobounce.net). Flag invalid, catch-all, spamtrap, abuse, and do-not-mail addresses before outreach, and check the validation credits remaining on your account.
Categories: Sales · Enrichment · Sales Engagement · Auth: API Key · Actions: 2

​
Authentication

​
API Key Authentication

Authenticate using your ZeroBounce API key
1

Step 1

Go to https://www.zerobounce.net and sign up or log in
2

Step 2

Open your account and navigate to the ‘API’ section
3

Step 3

Copy your API key
4

Step 4

Paste the API key below

​
Required Credentials

FieldDescriptionRequiredFormat
ZeroBounce API KeyYour ZeroBounce API key from your account settingsYes-

​
Available Actions

​
Parameters

​
email
string
required
Email address to validate (e.g., john@example.com)
​
ip_address
string
Optional IP address the email signed up from (improves scoring)

​
Response

{
  "additionalProperties": false,
  "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"
    },
    "sub_status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Sub Status"
    },
    "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"
    }
  },
  "required": [
    "success"
  ],
  "title": "VerifyEmailOutput",
  "type": "object"
}

​
Response

{
  "additionalProperties": false,
  "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"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetCreditsOutput",
  "type": "object"
}

​
Limits & Quotas

  • /validate: up to 80,000 requests per 10 seconds per key (~480,000/min).
  • /getcredits: up to 80,000 requests per hour (100,000 for ZeroBounce ONE customers) before a temporary block.
  • Each verify_email call consumes one validation credit.
  • Error model: ZeroBounce can answer HTTP 200 with an {"error": ...} envelope (invalid key / out of credits), and getcredits signals an invalid key with {"Credits": -1}. Non-2xx responses, error envelopes, and timeouts are caught and returned as success=False + error rather than raising. Plan retries on the agent side based on the error string.

Enrow

Findymail

Icypeas