A community node for n8n that integrates with the Bouncer E-Mail Verification API. Verify emails in real-time, run batch verifications, check domains, and detect toxic addresses.

API Coverage

The table below shows which endpoints are currently implemented:

| API Resource | Endpoint | Status | Operations | | -------------------------- | ------------------------- | ------- | ----------------------------------------------------------- | | Real-Time Verification | /v1/email/verify | ✅ Full | Verify E-Mail | | Batch (Async) | /v1.1/email/verify/batch| ✅ Full | Create, Check Status, Get Results, Finish, Delete | | Batch (Sync) | /v1/email/verify/batch | ✅ Full | Verify E-Mails | | Domain Verification | /v1/domain/verify | ✅ Full | Verify Domain | | Toxicity Check | /v1/toxicity | ✅ Full | Create List Job, Check Status, Download Results, Delete Job | | Credits | /v1/credits | ✅ Full | Get Available Credits |

Installation

1. Make a new workflow or open an existing one
2. Open the nodes panel by selecting + or pressing Tab
3. Search for Bouncer
4. Select Install to install the node for your instance

Credentials

1. Sign up for a Bouncer account
2. Navigate to your account settings and find your API key in the API section
3. In n8n, go to Credentials > Add credential
4. Search for Bouncer API and paste your key

Resources

| Operation | Description | | ------------ | ---------------------------------------------------------------------------- | | Verify E-Mail | Verify a single email address in real-time with configurable timeout (1-30s) |

Rate limit: 200 requests/minute

| Operation | Description | | ------------ | ----------------------------------------------------------------- | | Create | Submit up to 50,000 emails for offline verification | | Check Status | Monitor batch verification progress with optional statistics | | Get Results | Download results as JSON with filtering (all, deliverable, risky, undeliverable, unknown) | | Finish | Complete processing early and reclaim credits for unverified emails | | Delete | Remove batch data and results |

Rate limit: 60 batches/minute. Recommended batch size: 50,000–1,000,000 emails. Optional webhook callback on completion.

| Operation | Description | | ------------- | ---------------------------------------------------- | | Verify E-Mails | Verify up to 50 emails synchronously with immediate results |

Rate limit: 60 requests/minute

| Operation | Description | | ------------- | ---------------------------------------------------- | | Verify Domain | Check domain validity and mail server configuration |

Rate limit: 200 requests/minute

| Operation | Description | | ---------------- | ---------------------------------------- | | 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 |

Rate limit: 60 lists/minute

| Operation | Description | | -------------------- | ------------------------------------ | | Get Available Credits | Check your remaining Bouncer API credits |

Testing with Sandbox Emails

Bouncer provides free sandbox email addresses for testing without consuming credits.

| 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) | | [email protected] | Returns risky status (disposable) | | [email protected] | Returns deliverable with free provider | | [email protected] | Returns with various attributes |

You can modify any sandbox email with a + suffix to generate unique test addresses: [email protected]

Limitations

• Async batch verification: max 50,000 emails per request
• Sync batch verification: max 50 emails per request
• Real-time verification timeout: 1–30 seconds

Development

git clone https://github.com/hansdoebel/n8n-nodes-bouncer.git
cd n8n-nodes-bouncer
npm install
npm build
npm lint

License

MIT