truelist-n8n

n8n community node for Truelist email validation. Validate email addresses directly from your n8n workflows.

Start free — 100 validations + 10 enhanced credits, no credit card required. Get your API key →

Installation

In your n8n instance, go to Settings > Community Nodes and install:

truelist-n8n

Configuration

1. Add a Truelist API credential in n8n
2. Paste your API key (get one at app.truelist.io)
3. Use the Truelist node in your workflows

Operations

Email Resource

Validate

Validate a single email address synchronously and get an immediate result.

Inputs:

| Field | Required | Description | |-------|----------|-------------| | Email Address | Yes | The email address to validate |

Output: A single object with the validation result, including email_state (ok, invalid, risky, unknown) and email_sub_state.

List

List previously validated email addresses stored in your Truelist account.

Inputs:

| Field | Required | Description | |-------|----------|-------------| | Return All | No | Return all records (ignores Limit) | | Limit | No | Max results to return (1–100, default 50) | | Filters → Email State | No | Filter by: All, OK, Invalid, Risky, Unknown | | Filters → Email Sub-State | No | Filter by sub-state (disposable, role, no mailbox, etc.) | | Filters → Email Address | No | Search by a specific email address | | Filters → Batch ID | No | Filter to emails from a specific batch |

Batch Resource

Create

Upload a list of emails for bulk validation.

Inputs:

| Field | Required | Description | |-------|----------|-------------| | Emails | Yes | Comma-separated list, newline-separated, or a JSON array via expression | | Filename | No | Label for this batch (default: data.csv) | | Validation Strategy | No | fast, accurate (default), or enhanced — see Validation Strategies | | Webhook URL | No | URL to call when the batch finishes processing |

Output: Batch object including id, status, and progress fields.

Note: Batches start automatically within a few seconds — no separate "start" step is needed.

Get

Fetch the current status and details of a batch.

Inputs:

| Field | Required | Description | |-------|----------|-------------| | Batch ID | Yes | The UUID of the batch |

List

List all batches on your account.

Estimate

Estimate the credit cost and processing time for a list of emails before creating a batch. Useful for checking you have enough credits before kicking off a large run.

Inputs:

| Field | Required | Description | |-------|----------|-------------| | Emails | Yes | Comma-separated list or JSON array |

Download

Download validated batch results as a CSV file. The output item includes the CSV as binary data attached under the data key.

Inputs:

| Field | Required | Description | |-------|----------|-------------| | Batch ID | Yes | The UUID of the batch | | Result Type | Yes | Which result set to download (see below) |

Result types:

| Value | Description | |-------|-------------| | Annotated | All emails with validation results appended as extra columns | | Safest Bet | Only emails confirmed as valid — most conservative send list | | Highest Reach | Valid emails plus accept-all domains — most inclusive send list | | Only Invalid | Only emails that failed validation |

Delete

Permanently delete a batch and its results.

Inputs:

| Field | Required | Description | |-------|----------|-------------| | Batch ID | Yes | The UUID of the batch to delete |

Validation Results

| State | Sub-state | Meaning | |-------|-----------|---------| | ok | email_ok | Valid, deliverable email address | | ok | accept_all | Domain accepts all mail — individual deliverability unverified | | risky | is_disposable | Temporary or disposable email address | | risky | is_role | Role address (e.g. info@, support@, admin@) | | invalid | failed_syntax_check | Invalid email format | | invalid | failed_mx_check | Domain has no valid mail server | | invalid | failed_smtp_check | SMTP server rejected the address | | invalid | failed_no_mailbox | Mailbox does not exist | | invalid | failed_greylisted | Server greylisted the check; could not confirm | | unknown | — | Validity could not be determined |

Validation Strategies

| Strategy | Description | Cost | |----------|-------------|------| | Fast | SMTP check only — fastest option | 1 credit per email | | Accurate (default) | SMTP check with improved accuracy | 1 credit per email | | Enhanced | SMTP + HaveIBeenPwned lookup + browser-based validation | 1 standard + 1 enhanced credit |

Example Workflows

Validate a single email and branch on result

1. Add a Truelist node
2. Set Resource → Email, Operation → Validate
3. Set Email Address to {{ $json.email }}
4. Add an IF node after it: check {{ $json.email_state }} === "ok"

Bulk validate a list and download clean results

1. Truelist → Resource: Batch, Operation: Estimate — confirm you have enough credits
2. Truelist → Resource: Batch, Operation: Create — pass your email list
3. Loop / Wait until status is completed (poll with Truelist → Batch: Get)
4. Truelist → Resource: Batch, Operation: Download, Result Type: Safest Bet
5. Write the binary CSV to disk or pass it downstream

Resources

• Truelist website
• API documentation
• Verification result codes
• n8n community nodes docs
• Support

License

MIT