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

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

Install

Install the community node in n8n (e.g. by package name n8n-nodes-marketplace or @marketplace/n8n-nodes-marketplace). The exact package name may vary; see the SDK monorepo (tollara-sdk) or npm for the published package.

Credentials

Configure service secret and optional base URLs (gateway, core, usage) in n8n credentials. Use the credential type provided by the node.

First workflow

Add a Marketplace Trigger to receive webhook calls from the gateway; add Marketplace Invoke to call another service; use Marketplace Progress and Complete in async flows. For a lighter-weight alternative without the node, you can use an HTTP Request node plus a Code node to verify HMAC using the SDK spec (see the tollara-sdk repo).