tollara.ai

n8n integration

the tollara.ai n8n community node lets you build workflows that receive requests from the gateway (with HMAC verification), invoke services, and send progress and completion for async jobs.

What the integration does

  • Tollara Trigger — Webhook node that verifies HMAC (using service secret from credentials), parses X-Tollara-* headers, and outputs user context and body for the workflow.
  • Tollara Invoke — Calls the gateway POST /api/service/{serviceId}/endpoint/{endpointId}/invoke with service key; supports optional async and polling.
  • Tollara Progress / Tollara Complete — Send progress and completion to the URLs returned in the async response, signed with the service secret.
  • Tollara Validate Key — Calls the core-service validate endpoint; returns user, plan, and subscription context.

Install

Install the community node in n8n: Settings → Community nodes → install package n8n-nodes-tollara. Source and build steps live in the tollara-sdk monorepo (integration-n8n/). The JavaScript SDK (@tollara/service-sdk) is published separately on npm and is used inside the node package.

If the community node is not yet on npm for your environment, use a Webhook node plus a Code node (or @tollara/service-sdk) to verify HMAC — see the tollara-sdk repo README for the HMAC spec.

Credentials

Use the Tollara API credential type: service secret (required) and optional gateway, core, and usage base URLs for your deployment.

First workflow

Add a Tollara Trigger to receive webhook calls from the gateway; add Tollara Invoke to call another Tollara-listed service; use Tollara Progress and Tollara Complete in async flows. Point your service endpoint backend URL at the Trigger's production webhook URL when listing a proxied n8n workflow on tollara.ai.