Package Information
Available Nodes
Documentation generating…
Documentation
n8n-nodes-mailtester-ninja
The official MailTester Ninja node for n8n. Verify email addresses in real time inside any workflow, and find a person's work email from their name and company domain.
Every check talks to the recipient's own mail server over SMTP and stops before any message is sent. You get a plain verdict back, and MailTester Ninja keeps no copy of the addresses you verify.
Installation · Credentials · Operations · Usage · Example workflows · Compatibility · Resources
Installation
In n8n, open Settings > Community Nodes, select Install, and enter:
n8n-nodes-mailtester-ninja
See the n8n guide to installing community nodes for self-hosted setups.
Credentials
Create a MailTester Ninja API credential and paste your key:
- Free API token (starts with
mtf_): 50 checks a day, one request every 30 seconds, no card. Get one at https://mailtester.ninja/free-email-verification-api/ - Paid key (starts with
sub_): from 100,000 checks a day, see https://mailtester.ninja/verify-emails-unlimited/
The key is sent as the key query parameter. Test checks that the key is accepted without probing any mail server.
Operations
Verify
Checks one address. Output:
| Field | Meaning |
|---|---|
code |
ok valid, ko invalid, mb uncertain |
message |
Accepted, Rejected, Catch-All, No MX, MX Error, Disposable, Timeout, SPAM Block, Limited |
email, domain, mx |
The address checked, its domain and the mail server that answered |
Treat mb as uncertain, never as valid: a catch-all domain accepts every address, so no single mailbox can be confirmed there.
Find (paid key)
Takes a first name, a last name and a company domain. MailTester Ninja tests the 6 most common patterns (first.last, flast, first, firstlast, first_last, f.last) one by one on its server and returns the first address the mail server accepts. It stops early on catch-all domains (the most common pattern is then given in guess), domains without a mail server and disposable domains. Personal email providers such as gmail.com are not searched. Each pattern tested counts as one verification. Output: found, email, format (the pattern found, such as first.last), confidence (high with first and last name, medium with an initial, low with the first name only), guess, code, message, domain, tried, tested (every address checked, with its verdict), reason.
Usage
- Clean sign-ups: Webhook or form trigger, then Verify, then an If node on
codeequal tookbefore you write to your CRM. - Clean a list: Google Sheets rows, then Verify, then write
codeandmessageback to the sheet. - Enrich leads: a row with first name, last name and company domain, then Find, then your outreach tool.
- AI agents: the node can be used as a tool by the n8n AI Agent, so the agent can check an address before it sends anything.
The node paces its requests to stay within your key's rate, so you do not need Wait nodes: one request every 30 seconds with a free token, about 11 every 10 seconds on Starter and Pro, 23 on Ultimate. Executions that share a key in the same n8n instance share that rate. If the key is also used somewhere else at the same time and the API still answers HTTP 429, the node pauses for 11 seconds, retries once, then stops with a clear error.
Example workflows
Two ready-to-import workflows are in examples/. In n8n, open Workflows > Import from File, then select your MailTester Ninja API credential in the MailTester Ninja node.
verify-new-signups.json: a webhook receives a sign-up, Verify checks the address, and an If node sends valid addresses (code=ok) to your CRM and the others to review.find-work-email.json: a lead with first name, last name and company domain goes through Find, and an If node onfoundroutes it to your outreach tool (paid key).
Compatibility
Built with the n8n node CLI on n8n Nodes API version 1. No runtime dependencies.
Resources
- MailTester Ninja API documentation
- OpenAPI specification
- n8n integration guide
- n8n community nodes documentation