mailveri

Official MailVeri community node for n8n — real-time email verification and credit balance checks ($59/100K, non-expiring credits).

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 1.0.0
Author: MailVeri

Documentation

n8n-nodes-mailveri

Official MailVeri community node for n8n. Verify email addresses in real time and monitor your verification credit balance directly inside n8n workflows and AI Agents.

Features

  • Verify Email (Email -> Verify): Real-time syntax, MX record, disposable domain, catch-all detection, role-account classification, and mailbox deliverability checks via POST /v1/verify-mail/.
  • Check Credit Balance (Account -> Get Balance): Inspect remaining pay-as-you-go verification credits and daily quota details via GET /v1/get-balance/.
  • Zero-Waste UNKNOWN Billing: Returns credits_used: 0 when a target mail server cannot be verified conclusively.
  • AI Agent Compatible (usableAsTool: true): Attach MailVeri directly as a tool for n8n AI Agents (when N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true is enabled on self-hosted n8n).
  • Resilient Execution: Automatic single retry on HTTP 429 throttling (respecting Retry-After), per-item continueOnFail() isolation, optional pass-through of upstream item fields, and cleartext HTTP rejection for non-localhost endpoints.

Installation (Self-Hosted n8n)

Requires self-hosted n8n v1.0+ on Node.js 18.17+ (using MailVeri as an AI Agent tool requires n8n v1.50+ with N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true).

  1. Open your n8n instance and go to Settings → Community Nodes.
  2. Click Install.
  3. Enter n8n-nodes-mailveri, accept the community package risk prompt, and click Install.

To allow AI Agent workflows to invoke community nodes as tools in self-hosted n8n, set the environment variable:

N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true

Credentials

  1. Sign up or log in at app.mailveri.com (includes 1,000 free non-expiring credits).
  2. Create or copy an API key from API Keys.
  3. In n8n, create a new MailVeri API credential:
    • API Key: Paste your key (mv_...).
    • Base URL: Keep https://api.mailveri.com (only HTTPS URLs are permitted, except http://localhost / http://127.0.0.1 for local testing).

Output Fields (Email -> Verify)

Field Type Description
email string Normalized email address
status string VALID, INVALID, DISPOSABLE, ROLE_ACCOUNT, CATCH_ALL, FULL_INBOX, or UNKNOWN
is_valid boolean true when status === "VALID"
is_deliverable boolean true when status === "VALID" or "ROLE_ACCOUNT"
quality_score number Deliverability score (0–100)
is_forwarding boolean Whether the domain is a forwarding relay
credits_used number Credits deducted (1 on billed statuses, 0 on UNKNOWN)
balance number Remaining account credits after the check
message string Human-readable verification summary

Recommended Workflow Routing

  • status == VALID: Safe to enroll in outbound campaigns or sync to your CRM (HubSpot, Instantly, Smartlead).
  • status == CATCH_ALL or ROLE_ACCOUNT: Route to a secondary review queue or Google Sheet.
  • status == INVALID, DISPOSABLE, or FULL_INBOX: Quarantine or drop to keep bounce rates strictly under 1.5%.

Pricing

Pay-as-you-go credits never expire and carry zero monthly subscription fees: $9 / 10K, $59 / 100K, $299 / 1M, down to $999 / 5M ($0.0002/check). Learn more at mailveri.com/pricing or explore full setup workflows at mailveri.com/integrations/n8n.

Development & Local Testing

npm install
npm test
npm pack --dry-run

License

MIT

Discussion