Reference · Tools
Mailcheck
Verify email addresses using the Mailcheck.co API for deliverability, disposable detection, and trust scoring.
The Mailcheck node checks an email address for deliverability, whether it is disposable, and how much it should be trusted. A typical build is verifying every signup before it reaches your mailing list, so throwaway addresses never get counted as subscribers.
- Node type
- Action
- Parameters
- 4
- Outputs
- Output, Error
- Credentials
- Mailcheck API
Mailcheck
Verify email address deliverability and trust score.
Overview
Mailcheck is an email verification service that checks the deliverability, trust score and quality of an email address. This tool calls the Mailcheck.co API to validate one email address per input item and returns what the service knows about it: a trust rating, whether the address belongs to a disposable provider, whether the domain has MX records, whether the SMTP server accepts the address, whether the domain is catch-all, and any accounts associated with the address.
Category: Marketing
Tool Name: mailcheck
Version: 1
Appearance: Icon: lucide-MailCheck | Color: #4CAF50
Node Type
Action — processes input items and produces output
Input / Output
| Direction | Port(s) |
|---|---|
| Input | Input |
| Output | Output, Error |
Credentials
This tool requires Mailcheck API credentials. See the Credentials Guide for setup instructions.
Resources
| Resource | Value |
|---|---|
email |
Operations
| Operation | Value | Description |
|---|---|---|
| Check | check | Check the deliverability and trust score of an email address. |
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
string | Yes | — | The email address to verify. Supports expressions like {{ $json.email }}. | |
| Max Concurrency | number | No | 10 | Maximum number of items to process concurrently. |
Output Data
One output item per input item. The verification result is merged onto the input item JSON — the fields the API returns are added at the top level of the item alongside everything that was already there, so upstream fields survive. Binary data on the input item is forwarded unchanged. No operation on this node fans out into multiple items.
The merged fields come from the Mailcheck.co response and cover:
- the trust rating for the address,
- whether the address is disposable (a throwaway provider),
- whether the domain publishes MX records,
- whether the SMTP server accepts mail for the address,
- whether the domain is catch-all,
- any associated accounts the service has seen for the address.
Because the response is merged rather than nested, reference the fields directly downstream — for example {{ $json.trust }} — using the field names shown when you run the node once with a real address.
Usage Examples
- Verify an email address for deliverability
- Check if an email is from a disposable email provider
- Get the trust score for an email address
- Check if an email has associated GitHub or Microsoft accounts
Example Configuration
Verify a fixed address:
{
"type": "mailcheck",
"parameters": {
"resource": "email",
"operation": "check",
"email": "user@example.com"
}
}
Verify the address carried on each incoming item:
{
"type": "mailcheck",
"parameters": {
"resource": "email",
"operation": "check",
"email": "{{ $json.email }}"
}
}
Verify a large list, with concurrency turned down to stay inside your API rate limit:
{
"type": "mailcheck",
"parameters": {
"resource": "email",
"operation": "check",
"email": "{{ $json.contact.emailAddress }}",
"maxConcurrency": 5
}
}
Error Handling
| Mode | Behavior |
|---|---|
| stop | Halts workflow on first error |
| continue | Skips failed items, passes successful ones through |
| errorPort | Routes failed items to Error output port |
Tips
Verify an email address for deliverability, disposable status, and trust score using the Mailcheck.co API.
- One API call is made per input item, so a list of 500 addresses costs 500 calls. Use Max Concurrency to keep the request rate within your plan’s limit.
- An address that fails verification is not an error — the node still returns a result describing why. A failed item on the
Errorport means the API call itself failed (bad credentials, rate limit, network), not that the address is invalid. - Filter on the returned trust and disposable fields with a Switch or Filter node to split good addresses from the rest before sending mail.
Frequently asked questions
Does a failed verification appear on the Error output?
No — an address that fails verification is not an error. The node returns a result describing why. An item on the Error port means the API call itself failed: bad credentials, a rate limit, or a network problem.
How many API calls does a batch cost?
One per input item, so a list of 500 addresses costs 500 calls. Use Max Concurrency to keep the request rate inside your plan's limit.
How do I act on the result?
Filter on the returned trust and disposable indicators in a following If or Filter node, rather than expecting the node itself to drop bad addresses.
Which credential does it need?
A Mailcheck API credential.
Build with the Mailcheck node
Drop it into a workflow, wire it to an agent, or call it on a schedule. You'll need Mailcheck API credentials first.
Open BusyBotLast updated . Spotted something wrong? Tell us.