Package Information
Documentation
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)
- Go to Settings -> Community Nodes
- Click Install
- Enter
n8n-nodes-mailsafepro - Click Install
Manual Installation
cd ~/.n8n
npm install n8n-nodes-mailsafepro
Configuration
Get Your API Key
- Sign up at mailsafepro.com
- Go to your Dashboard
- Copy your API Key
Add Credentials in n8n
- Go to Credentials -> New
- Search for MailSafePro
- Enter your API Key
- (Optional) Change Base URL for self-hosted instances
- Click Save
Operations
Email Resource
Validate Single
Full validation of a single email address with SMTP verification.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| 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 |
|---|---|---|---|
| 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 usedvalidations_limit- Plan limitvalidations_remaining- Remaining validationsusage_percent- Usage percentageis_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:
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
- Package name starts with
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