n8n-nodes-mailsafepro

Enterprise-grade email validation node for n8n workflow automation

Features • Installation • Operations • Examples • Support

Features

Core Capabilities

| Feature | Description | |---------|-------------| | Single Validation | Real-time email validation with full analysis | | Batch Validation | Process up to 10,000 emails asynchronously | | Quick Check | Fast syntax/domain validation without SMTP | | Statistics | Automatic batch statistics calculation |

Validation Features

| Feature | Description | |---------|-------------| | SMTP Verification | Real mailbox existence checking | | Risk Scoring | Multi-factor risk assessment (0-1 scale) | | DNS Security | SPF, DKIM, DMARC validation | | Spam Trap Detection | Identify honeypot addresses | | Disposable Detection | Block temporary email services | | Role Email Detection | Identify generic addresses (admin@, info@) | | Catch-All Detection | Identify domains accepting all emails |

Enriched Output

Every validation result includes computed fields for easy workflow logic:

| Field | Type | Description | |-------|------|-------------| | risk_level | string | low / medium / high | | quality_tier | string | excellent / good / fair / poor | | is_safe_to_send | boolean | Safe to send (valid + low risk) | | is_high_risk | boolean | Risk score >= 0.7 | | should_review | boolean | Medium risk, needs manual review | | recommendation | string | Human-readable action recommendation | | deliverability_status | string | high / medium / low / unknown |

Installation

Community Nodes (Recommended)

1. Go to Settings -> Community Nodes
2. Click Install
3. Enter n8n-nodes-mailsafepro
4. Click Install

Manual Installation

cd ~/.n8n
npm install n8n-nodes-mailsafepro

Configuration

Get Your API Key

1. Sign up at mailsafepro.com
2. Go to your Dashboard
3. Copy your API Key

Add Credentials in n8n

1. Go to Credentials -> New
2. Search for MailSafePro
3. Enter your API Key
4. (Optional) Change Base URL for self-hosted instances
5. Click Save

Operations

Email Resource

Validate Single

Full validation of a single email address with SMTP verification.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | Email | string | Yes | - | Email address to validate | | Check SMTP | boolean | No | true | Perform SMTP mailbox verification | | Include Raw DNS | boolean | No | false | Include full DNS records | | Timeout | number | No | 30 | Request timeout in seconds |

Validate Multiple (Sync)

Validate multiple emails synchronously (max 100).

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | Emails | string | Yes | - | Comma/newline/semicolon separated | | Check SMTP | boolean | No | false | SMTP verification | | Return Individual Results | boolean | No | true | Split into separate items | | Include Statistics | boolean | No | true | Include batch statistics |

Quick Check

Fast syntax and domain validation without SMTP (ideal for real-time form validation).

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | Email | string | Yes | Email address to check |

Batch Job Resource

Create Job

Create an async batch validation job for large lists.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | Emails | string | Yes | - | List of emails (max 10,000) | | Check SMTP | boolean | No | false | SMTP verification | | Priority | select | No | normal | low / normal / high | | Callback URL | string | No | - | Webhook for completion | | Job Name | string | No | - | Identifier for the job | | Deduplicate | boolean | No | true | Remove duplicates |

Get Status

Check the current status of a batch job.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | Job ID | string | Yes | The batch job ID |

Returns: Status with progress_percent, is_completed, is_processing, is_failed

Get Results

Retrieve validation results from a completed job.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | Job ID | string | Yes | - | The batch job ID | | Page | number | No | 1 | Page number | | Page Size | number | No | 100 | Results per page (max 1000) | | Filter Status | select | No | All | Filter by validation status | | Return Individual Results | boolean | No | false | Split into items | | Include Statistics | boolean | No | true | Include batch stats |

List Jobs

List all batch jobs for your account.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | Limit | number | No | 20 | Max jobs to return | | Filter Status | select | No | All | Filter by job status |

Cancel Job

Cancel a pending or processing batch job.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | Job ID | string | Yes | The batch job ID |

Account Resource

Get Usage

Get current API usage statistics.

Returns:

• validations_used - Number of validations used
• validations_limit - Plan limit
• validations_remaining - Remaining validations
• usage_percent - Usage percentage
• is_near_limit - True if usage >= 80%
• is_at_limit - True if usage >= 100%

Get Plan

Get subscription plan details and limits.

Example Workflows

1. Real-Time Signup Validation

Webhook -> MailSafePro: Validate Single -> IF: is_safe_to_send
                                                      |-- true -> Create User
                                                      |-- false -> Return Error

2. Weekly Email List Cleanup

Schedule: Weekly -> Get Subscribers from DB -> MailSafePro: Create Batch Job
                                                                   |
                                                                   v
                                                    MailSafePro: Get Results (poll manually)
                                                                   |
                                                                   v
                                                    Update DB: Remove Invalid

3. Lead Scoring with Email Quality

CRM Trigger: New Lead -> MailSafePro: Validate Single -> Code: Calculate Score
                                                                          |
                                                                          v
                                                        Update CRM Lead Score

4. Form Validation with Detailed Feedback

Form Submit -> MailSafePro: Quick Check -> Switch: status
                                                |-- deliverable -> Save Lead
                                                |-- risky -> Flag for Review
                                                |-- undeliverable -> Return Error Message

5. Batch Processing with Statistics

Read CSV -> MailSafePro: Validate Multiple -> Split by: risk_level
                                                   |-- low -> Safe List
                                                   |-- medium -> Review Queue
                                                   |-- high -> Reject List

Understanding Results

Risk Levels

| Score | Level | Recommended Action | |-------|-------|-------------------| | 0.00 - 0.29 | Low | Safe to send | | 0.30 - 0.49 | Medium-Low | Safe with monitoring | | 0.50 - 0.69 | Medium | Consider verification | | 0.70 - 1.00 | High | Manual review required |

Status Values

| Status | Description | Action | |--------|-------------|--------| | deliverable | Valid email, mailbox exists | Send | | undeliverable | Invalid or non-existent | Remove | | risky | Valid but has risk factors | Review | | unknown | Could not fully verify | Retry later |

Quality Tiers

| Tier | Score Range | Description | |------|-------------|-------------| | Excellent | > 0.80 | High-quality, engaged email | | Good | 0.61 - 0.80 | Reliable email address | | Fair | 0.41 - 0.60 | Acceptable with some concerns | | Poor | <= 0.40 | Low quality, high risk |

Rate Limits

| Plan | Requests/Min | Sync Batch | Async Batch | |------|--------------|------------|-------------| | FREE | 1 | 10 | 50 | | PREMIUM | 100 | 100 | 1,000 | | ENTERPRISE | 1,000 | 100 | 10,000 |

Development

# Clone
git clone https://github.com/mailsafepro/n8n-nodes-mailsafepro.git
cd n8n-nodes-mailsafepro

# Install dependencies
npm install

# Development with hot reload
npm run dev

# Run tests
npm test

# Build for production
npm run build

Support

| Resource | Link | |----------|------| | API Documentation | docs.mailsafepro.com | | n8n Community | community.n8n.io | | Report Issues | GitHub Issues | | Email Support | [email protected] | | Website | mailsafepro.com |

Submit to n8n

To get your node listed in the official n8n integrations:

1. Ensure your node follows n8n standards:

   • Package name starts with n8n-nodes-
   • Include proper documentation
   • Add keywords to package.json: n8n-community-node-package, n8n

2. Submit for review:

   • Go to n8n Creator Portal
   • Submit your node for verification

License

MIT License - see LICENSE for details.

Changelog

v1.1.0 (2026-02-16)

• Removed Wait for Completion operation (not allowed in community nodes)
• Removed automatic retry with exponential backoff
• Improved batch job management
• Enhanced error handling

v1.0.0 (2026-01-04)

Initial Release

• Email validation with enriched results
  • Single email validation with SMTP
  • Quick check (syntax/domain only)
  • Multiple emails sync validation (up to 100)
• Batch job management
  • Create async jobs (up to 10,000 emails)
  • Get job status with progress
  • Get paginated results with filters
  • List all jobs
  • Cancel pending jobs
• Account management
  • Get usage statistics
  • Get plan details
• Batch statistics calculation
• Email deduplication
• Configurable timeouts
• Comprehensive error handling
• Full TypeScript support

Made by MailSafePro