n8n-nodes-truora

Single, consolidated n8n community node for all Truora APIs: Validators, Checks, and Digital Identity (Connect).

Features

• Validators: create/get/perform validations (document, face, email, phone, name, address, identity, background)
• Enrollments: create/get/update (face/email/phone)
• Checks: create/get background checks (person, vehicle, company, custom)
• Connect (Digital Identity): generic request helper
• OpenAPI (All): dropdowns to explore and call any endpoint from Truora’s OpenAPI specs (grouped by API/method/category)

Installation

Via n8n (recommended)

1. In your n8n instance, go to Settings → Community Nodes
2. Install package: n8n-nodes-truora

Via npm

npm install n8n-nodes-truora

Credentials

Create credentials of type “Truora API”. Fields:

• API Key: sent in Truora-API-Key header
• Environment: sandbox or production (affects Validators base URL)
• Checks Base URL (optional): defaults to https://api.checks.truora.com
• Connect Base URL (optional): defaults to https://api.connect.truora.com
• Fingerprint Authorization Token (optional): for Connect endpoints that require it

Node overview

• Resource: Validation, Enrollment, Check, Generic (Connect), OpenAPI (All)
• OpenAPI (All): choose API + Method → Category → Endpoint. Optionally override path, add headers (JSON), query, and body (JSON).

Usage examples

Create a document validation (Validators)

• Resource: Validation
• Operation: Create
• Fields: accountId, validatorType = document-validation, documentType, countryCode, document images

Create a background check (Checks)

• Resource: Check
• Operation: Create
• Fields: country, type, userAuthorized, additionalFields (e.g., national_id, first_name, last_name)

Call any endpoint (OpenAPI All)

• Resource: OpenAPI (All)
• API + Method + Category → Endpoint
• Optional: Path override, Headers (JSON), Query, Body (JSON)

Development

# install
npm i

# build (generates endpoints JSON from openapipreprocessed.json and copies assets)
npm run build

# lint / format
npm run lint
npm run format

The OpenAPI endpoints dropdown is generated from the repository’s openapipreprocessed.json using scripts/build_endpoints.js. If you update the OpenAPI files, rerun a build to refresh the list.

Publish

npm version patch   # or minor/major
npm publish --access public

Links

• ZapSign node (digital signature): https://github.com/ZapSign/n8n-nodes-zapsign
• Truora docs: https://dev.truora.com/

License

MIT