Description

n8n-nodes-zerobounce

This is an n8n community node that lets you use the complete ZeroBounce email validation and enrichment API in your n8n workflows.

ZeroBounce is an email validation and deliverability service that helps you verify email addresses, reduce bounce rates, improve email marketing performance, find email addresses, and more.

n8n is a fair-code licensed workflow automation platform.

Table of Contents

• Installation
• Operations
  • Account
  • Validation
  • AI Scoring
  • Email Finder
  • Domain Search
  • Activity Data
• Credentials
• Compatibility
• Usage
• Resources
• Version History

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Node Installation

1. Go to Settings > Community Nodes in your n8n instance
2. Click Install
3. Enter n8n-nodes-zerobounce in the npm package name field
4. Click Install

Manual Installation

To use this node locally or for development:

npm install n8n-nodes-zerobounce

Operations

The ZeroBounce node is organized into 6 main resources with comprehensive operations:

Account Operations

Manage your ZeroBounce account and monitor API usage.

Validation Operations

Validate email addresses individually or in bulk.

AI Scoring Operations

Use AI-powered email scoring to assess email quality and deliverability.

Email Finder Operations

Find and verify professional email addresses based on name and domain.

Domain Search Operations

Search for all email addresses associated with a domain.

Activity Data Operations

Get email activity and engagement data.

Credentials

To use this node, you need a ZeroBounce API key:

1. Sign up for a ZeroBounce account
2. Navigate to your API Dashboard
3. Click 'Create a new API Key'
4. Enter a descriptive name (e.g., 'n8n integration')
5. Set the key to active and optionally configure IP restrictions
6. Copy the API key
7. In n8n, create new ZeroBounce API credentials
8. Paste your API key into the credentials

The credential test will verify your API key by checking your credit balance.

Compatibility

• Tested with n8n version 1.50.0 and above
• Requires Node.js 18.17.0 or higher

Usage

Validate a Single Email

1. Add the ZeroBounce node to your workflow
2. Select Validation as the resource
3. Select Validate Email operation
4. Enter the email address you want to validate
5. Optionally provide an IP address for additional validation
6. Execute the workflow

Response includes:

• Validation status (valid, invalid, catch-all, unknown, spamtrap, abuse, do_not_mail)
• Email quality score
• Additional information (free/disposable/role flags, did you mean suggestions, etc.)

Check API Credits

1. Add the ZeroBounce node
2. Select Account as the resource
3. Select Get Credits Balance operation
4. Execute to see your remaining credits

AI Email Scoring

1. Add the ZeroBounce node
2. Select AI Scoring as the resource
3. Select Score Email operation
4. Enter the email address
5. Execute to get AI-powered deliverability scores

Find Email Address

1. Add the ZeroBounce node
2. Select Email Finder as the resource
3. Select Find Email operation
4. Enter the domain (e.g., google.com)
5. Enter first name and/or last name
6. Execute to find potential email addresses

Domain Search

1. Add the ZeroBounce node
2. Select Domain Search as the resource
3. Select Search Domain operation
4. Enter the domain to search
5. Execute to get all associated email addresses

Bulk File Operations

For bulk validation, scoring, email finding, or domain search:

1. Add the ZeroBounce node
2. Select the appropriate resource (Validation, AI Scoring, Email Finder, or Domain Search)
3. Select Send File operation
4. Provide CSV data in the CSV Data field
5. Configure column mappings and settings
6. Optionally add a webhook return URL for completion notifications
7. Execute to upload the file
8. Use the returned file_id with Check File Status to monitor progress
9. Once complete, use Get File Results to retrieve the processed data
10. Clean up with Delete File when done

Webhook Integration for Bulk Operations

To get notified when bulk processing completes:

1. Add a Wait node before your ZeroBounce node
2. Configure it to wait for a webhook
3. Set HTTP Method to 'POST'
4. Copy the webhook URL
5. In the ZeroBounce Send File operation, paste the webhook URL in the Return URL field
6. When processing completes, ZeroBounce will POST to your webhook and resume the workflow

Batch Email Validation (JSON)

For smaller batches without file upload:

1. Add the ZeroBounce node
2. Select Validation resource
3. Select Validate Batch operation
4. Provide JSON array of emails:

   [
     {"email": "test1@example.com"},
     {"email": "test2@example.com"},
     {"email": "test3@example.com"}
   ]
   

5. Execute for instant batch validation

Resources

• n8n community nodes documentation
• ZeroBounce API documentation
• ZeroBounce website
• ZeroBounce API Dashboard

Version History

• 0.2.0 – Major feature update

  • Added AI Scoring operations (single + bulk)
  • Added Email Finder operations (single + bulk)
  • Added Domain Search operations (single + bulk)
  • Enhanced bulk file operations with CSV upload support
  • Added webhook integration for async bulk operations
  • Reorganized operations into resource-based structure
  • Improved error handling and validation

• 0.1.0 – Initial release

  • Email validation (single + batch)
  • Basic batch validation support
  • Credits and API usage tracking
  • Activity data retrieval

License

MIT

Support

If you encounter any issues or have questions:

• Check the ZeroBounce API documentation
• Visit the n8n community forum
• Create an issue on GitHub

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.