n8n-nodes-usebouncer

v1.0.1

Published

7 days ago

Bouncer E-Mail verification custom node for n8n

🦍 n8n-nodes-bouncer

n8n is a fair-code licensed workflow automation platform.

This is a custom n8n community node providing a complete integration with the Bouncer E-Mail Verification API.

📚 Table of Contents

✨ Features

🎯 Real-Time Verification

Verify E-Mail: Verify single email address in real-time with configurable timeout (1-30 seconds)
Perfect for signup forms and real-time validation
Rate limit: 200 requests/minute

📦 Batch Verification (Asynchronous)

Create Batch Request: Verify up to 50,000 emails in offline manner
Check Status: Monitor batch verification progress with optional statistics
Get Results: Download verification results as JSON with filtering options (all, deliverable, risky, undeliverable, unknown)
Finish: Complete processing early and reclaim credits for unverified emails
Delete Request: Remove batch data and results
Recommended batch size: 50,000-1,000,000 emails
Optional webhook callback when processing completes
Rate limit: 60 batches/minute

⚡ Batch Verification (Synchronous)

Verify E-Mails: Verify up to 50 emails synchronously with immediate results
Ideal for small batches requiring instant feedback
Rate limit: 60 requests/minute

🌐 Domain Verification

Verify Domain: Check domain validity and mail server configuration
Validate domain-level email deliverability
Rate limit: 200 requests/minute

🛡️ Toxicity Check

Create List Job: Submit email list for toxicity analysis
Check Status: Monitor toxicity check progress
Download Results: Retrieve toxicity analysis results
Delete Job: Remove toxicity check data
Identify potentially harmful or spam email addresses
Rate limit: 60 lists/minute

💳 Credits Management

Get Available Credits: Check your remaining Bouncer API credits

🔧 Technical Features

Declarative Style: Uses n8n's declarative routing for simplified API integration
Type-Safe: Written in TypeScript with full type definitions
Comprehensive Error Handling: Robust error messages and validation
Built with n8n Best Practices: Follows official n8n community node guidelines

📦 Installation

Follow the installation guide in the n8n community nodes documentation.

Go to Settings > Community Nodes.
Select Install.
Enter the npm package name: n8n-nodes-usebouncer
Agree to the risks of using community nodes: select I understand the risks of installing unverified code from a public source.
Select Install. n8n installs the node and returns to the Community Nodes list in Settings.

🔐 Authentication

This node uses the Bouncer API key for authentication.

Getting Your API Key

Sign up for a Bouncer account
Navigate to your account settings
Find your API key in the API section
Copy the API key

Configuring in n8n

In your n8n workflow, add the Bouncer node
Click on Create New Credentials
Enter your API key
Click Save to test and save the credentials

The node will automatically include your API key in the x-api-key header for all requests.

🧪 Testing with Sandbox Emails

Bouncer provides free sandbox email addresses that you can use to test the integration without consuming credits. These are perfect for development and testing your workflows.

Available Sandbox Emails

| Email Address | Expected Result | |---------------|-----------------| | [email protected] | Returns deliverable status | | [email protected] | Returns undeliverable status | | [email protected] | Returns unknown status | | [email protected] | Returns risky status (accept-all domain) | | [email protected] | Returns risky status (disposable email) | | [email protected] | Returns deliverable with free provider flag | | [email protected] | Returns with various attributes |

Using the Plus (+) Suffix

You can modify any sandbox email with a + suffix to generate unique test addresses without consuming credits:

[email protected]
[email protected]
[email protected]

Example Test Workflow

Add the Bouncer node to your workflow
Select Real Time as the Resource
Select Verify E-Mail as the Operation
Enter [email protected] as the email
Execute the node - you should see a deliverable status response
Test other sandbox emails to see different response scenarios

Note: Sandbox emails work with all verification endpoints (Real-Time, Batch, Batch Sync) and don't count against your credit balance.

🛠️ Development

Setup Development Environment

# Clone the repository
git clone https://github.com/hansdoebel/n8n-nodes-bouncer.git
cd n8n-nodes-bouncer

# Install dependencies
pnpm install

# Build the project
pnpm build

# Watch mode (auto-compile on changes)
pnpm dev

Code Quality

# Lint code
pnpm lint

# Fix linting issues
pnpm lintfix

# Format code
pnpm format

🔗 Resources

📜 Version History

1.0.0 – Complete implementation with all Bouncer API operations
- ✅ Real-Time E-Mail Verification
- ✅ Batch E-Mail Verification
- ✅ Domain Verification
- ✅ Toxicity Check
- ✅ Credits Management

💝 Support

If you find this node helpful, consider buying me a coffee!

📄 License

MIT