mailsafepro

n8n community node for MailSafePro Email Validation API - Enterprise email validation with risk scoring, SMTP verification, batch processing, and deliverability analysis

Package Information

Downloads: 20 weekly / 345 monthly
Latest Version: 1.1.2
Author: MailSafePro

Documentation

n8n-nodes-mailsafepro

n8n
License
Version
Node
TypeScript

Enterprise-grade email validation node for n8n workflow automation

FeaturesInstallationOperationsExamplesSupport


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 support@mailsafepro.com
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:


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

Discussion