n8n-nodes-quickemailverification

n8n-nodes-quickemailverification

This is an n8n community node for QuickEmailVerification API. It provides email verification functionality with caching support.

QuickEmailVerification node in action showing email verification with caching capabilities

Installation

Follow these steps to install the node:

# Install from npm
npm install n8n-nodes-quickemailverification

# Or install from source
npm install

Features

• Email verification using QuickEmailVerification API
• Response caching with configurable TTL
• Rate limiting and retry handling
• Secure credential storage
• Remaining credits tracking
• Timestamp tracking for verifications

Configuration

• Get your API key from QuickEmailVerification
• Add your API credentials in n8n credentials manager
• Configure optional caching settings:
  • Enable/disable caching (default: enabled)
  • Set cache TTL in days (default: 30 days)

Usage

• Add the QuickEmailVerification node to your workflow
• Configure the node with your credentials
• Connect input nodes that provide email addresses
• Use output for email verification results

Response Format

The node returns verification results including:

• Validation status
• Detailed reason
• Additional email information (disposable, role-based, etc.)
• MX record information
• Caching status (cached: true/false)
• Verification timestamp (verifiedAt in ISO 8601 format)
• Remaining API credits (remainingCredits)

Example response:

{
    "result": "valid",
    "reason": "accepted_email",
    "disposable": false,
    "accept_all": false,
    "role": false,
    "free": false,
    "email": "[e-mail]",
    "user": "test",
    "domain": "example.com",
    "mx_record": true,
    "mx_domain": "example.com",
    "safe_to_send": true,
    "did_you_mean": "",
    "success": true,
    "message": null,
    "cached": false,
    "verifiedAt": "2024-03-14T12:34:56.789Z",
    "remainingCredits": 950
}

Error Handling

The node handles various API response codes:

• 200: Success
• 400: Bad Request
• 401: Invalid API key
• 402: Credit limit reached
• 403: Account disabled
• 404: Invalid endpoint
• 429: Rate limit exceeded
• 500: Server error

Best Practices

• Enable caching for frequently checked emails
• Use batch operations for multiple emails
• Monitor remaining credits
• Handle rate limits with appropriate delays
• Validate email format before verification
• Monitor cache usage for optimal performance

Support

If you find this node helpful and would like to support its development:

License

MIT

Changelog

[1.2.3-1.2.4] - 2025-04-29

• Fixed domain cache to only store results for domains with accept_all=true (handles API returning string/boolean)
• Implemented cache versioning: cache is now invalidated automatically if node version changes, using a special cache_version key in the cache content
• Old cache files are automatically cleared of stale data on first use after upgrade; no new files are created
• Improved cache safety and upgrade experience; no risk of using stale or incompatible cache after node update