Package Information
Available Nodes
Documentation
n8n-nodes-bouncer
Installation | Credentials | Resources | Sandbox Emails | Limitations | Development
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:
View all endpoints
| 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
- Make a new workflow or open an existing one
- Open the nodes panel by selecting + or pressing Tab
- Search for Bouncer
- Select Install to install the node for your instance
Credentials
- Sign up for a Bouncer account
- Navigate to your account settings and find your API key in the API section
- In n8n, go to Credentials > Add credential
- Search for Bouncer API and paste your key
Resources
Real-Time Verification
| Operation | Description |
|---|---|
| Verify E-Mail | Verify a single email address in real-time with configurable timeout (1-30s) |
Rate limit: 200 requests/minute
Batch Verification (Async)
| 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.
Batch Verification (Sync)
| Operation | Description |
|---|---|
| Verify E-Mails | Verify up to 50 emails synchronously with immediate results |
Rate limit: 60 requests/minute
Domain Verification
| Operation | Description |
|---|---|
| Verify Domain | Check domain validity and mail server configuration |
Rate limit: 200 requests/minute
Toxicity Check
| 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
Credits
| 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.
View sandbox emails
| Email Address | Expected Result |
|---|---|
deliverable@sandbox.usebouncer.com |
Returns deliverable status |
undeliverable@sandbox.usebouncer.com |
Returns undeliverable status |
unknown@sandbox.usebouncer.com |
Returns unknown status |
accept-all@sandbox.usebouncer.com |
Returns risky status (accept-all) |
disposable@sandbox.usebouncer.com |
Returns risky status (disposable) |
free@sandbox.usebouncer.com |
Returns deliverable with free provider |
other@sandbox.usebouncer.com |
Returns with various attributes |
You can modify any sandbox email with a + suffix to generate unique test addresses: deliverable+test1@sandbox.usebouncer.com
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
GitHub | Issues | Bouncer Docs