n8n-nodes-trueform

This is the official n8n community node for the Trueform email validation API. It checks email format, provider type, disposable-domain status, mail routing, and common domain typos without an API key.

n8n is a fair-code licensed workflow automation platform.

Installation Operations Compatibility Usage Resources Version history

Installation

Install n8n-nodes-trueform from Settings > Community Nodes in a self-hosted n8n instance. See n8n's community-node installation guide for other installation methods.

Operations

• Validate email sends one validation request for each incoming n8n item.
• The Email field accepts expressions such as {{ $json.email }}.
• The output contains the normalized address and all seven Trueform validation fields.

Trueform's public API does not require credentials.

Compatibility

Requires Node.js 22.22 or newer and n8n 2.0 or newer. CI tests the package against the current n8n node tooling.

Usage

Connect any node that produces an email field, set Email to an expression such as {{ $json.email }}, then route the result with an If or Switch node.

is_deliverable is a domain-level verdict. It does not confirm that a specific mailbox exists.

An undeliverable address is a successful node result with is_deliverable: false. Temporary DNS failures return 503, and rate limits return 429; n8n keeps these as execution errors so they are never mistaken for invalid addresses. Use n8n retry settings or an error workflow for those temporary conditions.

The public API allows 60 requests per 60 seconds per source IP. For larger lists, process items in batches and wait between batches.

Example workflow:

Webhook -> Trueform -> If is_deliverable -> CRM

Resources

• Trueform documentation
• Trueform API reference
• n8n community nodes documentation
• Source code
• Contributing guide
• Security policy

Development

npm install
npm run check
npm run test:live

npm run test:live sends one request to the production Trueform API. The regular test suite does not require network access.

Version history

0.1.0

• Initial Validate email operation.
• Credential-free integration with the public Trueform API.

License

MIT. See LICENSE.