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.

| Operation | Description | |-----------|-------------| | Get Credits Balance | Check your remaining API credits | | Get API Usage | Get detailed API usage statistics for a date range |

Validation Operations

Validate email addresses individually or in bulk.

| Operation | Description | |-----------|-------------| | Validate Email | Validate a single email address with detailed results | | Validate Batch | Submit a batch of emails (JSON array) for validation | | Send File | Upload a CSV file for bulk validation | | Check File Status | Check the processing status of a bulk validation file | | Get File Results | Retrieve the results of a completed bulk validation | | Delete File | Delete a bulk validation file from ZeroBounce servers |

AI Scoring Operations

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

| Operation | Description | |-----------|-------------| | Score Email | Get AI-powered deliverability score for a single email | | Send File | Upload a CSV file for bulk AI scoring | | Check File Status | Check the processing status of a bulk scoring file | | Get File Results | Retrieve the results of bulk AI scoring | | Delete File | Delete a bulk scoring file |

Email Finder Operations

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

| Operation | Description | |-----------|-------------| | Find Email | Find email address from first name, last name, and domain | | Send File | Upload a CSV file for bulk email finding | | Check File Status | Check the processing status of a bulk email finder file | | Get File Results | Retrieve the results of bulk email finding | | Delete File | Delete a bulk email finder file |

Domain Search Operations

Search for all email addresses associated with a domain.

| Operation | Description | |-----------|-------------| | Search Domain | Find all email addresses associated with a domain | | Send File | Upload a CSV file for bulk domain searching | | Check File Status | Check the processing status of a bulk domain search file | | Get File Results | Retrieve the results of bulk domain search | | Delete File | Delete a bulk domain search file |

Activity Data Operations

Get email activity and engagement data.

| Operation | Description | |-----------|-------------| | Get Activity Data | Retrieve activity data for a specific email address |

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": "[email protected]"},
     {"email": "[email protected]"},
     {"email": "[email protected]"}
   ]

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.