Package Information
Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 1.0.0
Author: MailVeri
Available Nodes
Documentation generating…
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 viaPOST /v1/verify-mail/. - Check Credit Balance (
Account -> Get Balance): Inspect remaining pay-as-you-go verification credits and daily quota details viaGET /v1/get-balance/. - Zero-Waste
UNKNOWNBilling: Returnscredits_used: 0when a target mail server cannot be verified conclusively. - AI Agent Compatible (
usableAsTool: true): Attach MailVeri directly as a tool for n8n AI Agents (whenN8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=trueis enabled on self-hosted n8n). - Resilient Execution: Automatic single retry on HTTP
429throttling (respectingRetry-After), per-itemcontinueOnFail()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).
- Open your n8n instance and go to Settings → Community Nodes.
- Click Install.
- 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
- Sign up or log in at app.mailveri.com (includes 1,000 free non-expiring credits).
- Create or copy an API key from API Keys.
- 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, excepthttp://localhost/http://127.0.0.1for local testing).
- API Key: Paste your key (
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_ALLorROLE_ACCOUNT: Route to a secondary review queue or Google Sheet.status == INVALID,DISPOSABLE, orFULL_INBOX: Quarantine or drop to keep bounce rates strictly under1.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