thirdfactor-obsidian

n8n community nodes for ThirdFactor Obsidian — identity verification triggers and actions

Package Information

Released: 3 mo ago
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.0

Available Nodes

Documentation generating…

ThirdFactor Obsidian icon
ThirdFactor Obsidian
Interact with the ThirdFactor Obsidian identity-verification platform (sessions, tags, AML checks)
ThirdFactor Obsidian Trigger icon
ThirdFactor Obsidian Trigger
Starts the workflow when ThirdFactor Obsidian events occur (verifications, review cases, AML hits, credits, …)

Documentation

n8n-nodes-thirdfactor-obsidian

n8n community nodes for ThirdFactor Obsidian — the
identity-verification (KYC/KYB) platform. A webhook trigger for platform
events plus an action node for sessions, tags, and standalone AML checks.

Installation

In n8n: Settings → Community Nodes → Install and enter
n8n-nodes-thirdfactor-obsidian, or on a self-hosted instance:

npm install n8n-nodes-thirdfactor-obsidian

Credentials

Create a ThirdFactor Obsidian API credential:

Field Description
Base URL Your deployment's API base URL, e.g. https://api.thirdfactor.example.
API Key A tenant API key (sk_…) from the console (Settings → API Keys). Sent as the X-API-Key header.

The credential test calls GET /v3/automation/me/ on your deployment.

ThirdFactor Obsidian Trigger

Webhook trigger backed by the platform's REST-hooks API. When the workflow is
activated, the node subscribes via POST /v3/automation/subscriptions/
(source: "n8n"); deactivating unsubscribes.

  • Events — multi-select, fetched live from /v3/automation/events/
    (session lifecycle, module results, AML/blocklist/risk/duplicate signals,
    review cases, contact/document progress, credits).
  • Workflows — optional filter; only sessions of the selected verification
    workflows fire the trigger.
  • Modules — optional filter for module-scoped events
    (e.g. module.completed for AML_SCREENING only).
  • Verify Signature (default on) — validates the X-Webhook-Signature
    header (t=<unix>,v1=<hex>, HMAC-SHA256 of "<t>.<raw_body>" with the
    subscription secret) and rejects mismatched or stale (>5 min) deliveries
    with HTTP 401.

Each delivery arrives as one item:

{
  "payload_version": 1,
  "event": "session.approved",
  "id": "<delivery uuid>",
  "created_at": "<iso timestamp>",
  "data": { "session": { "id": "…", "status": "approved", "vendor_data": "…" } }
}

To test without waiting for a real event, use Listen for test event and
complete a verification, or fetch a recent payload yourself from
GET /v3/automation/samples/<event>/.

ThirdFactor Obsidian (action node)

Resource Operation Endpoint
Session Create POST /v3/session/ — returns the hosted verification url
Session Get GET /v3/session/<id>/
Session Get Decision GET /v3/session/<id>/decision/
Session Get Many GET /v3/session/ (status / page / page size filters)
Session Add Tag POST /v3/session/<id>/tags/
Tools AML Check POST /v3/tools/aml-check/ (billed per use)

Session → Create offers a dynamic Workflow dropdown (from
/v3/workflows/) plus vendor data, contact email/phone, expiry, metadata
(JSON), callback URL, and locale.

Development

cd sdks/n8n
npm install
npm run build   # tsc + copies the node icon (thirdfactor.png — the product favicon) into dist/

Link into a local n8n for manual testing:

npm link
cd ~/.n8n/custom   # or your n8n custom-extensions dir
npm link n8n-nodes-thirdfactor-obsidian

Compatibility

Built against n8n-workflow ^1.70 with the community-node API version 1;
requires Node.js ≥ 18.

Discussion