AddThisFeature

n8n Workflow Trigger

Trigger self-hosted or cloud n8n workflows from product events with signed payloads.

moderate Integrations

What it adds

An outbound trigger to user-supplied n8n webhook URLs, with shared-secret signing, versioned payloads, and a bounded wait for responding workflows.

What your agent is told to do

5
  1. 1

    Treat every destination as untrusted because self-hosted n8n means the user picks the host. Resolve the hostname before each connection, reject private, loopback, link-local, and metadata addresses, and re-check on redirect rather than only when the URL is saved.

  2. 2

    Offer an optional shared secret per destination. When it is set, sign the request body with it and include a timestamp in the signed material so the workflow can verify origin and reject replays.

  3. 3

    Version the payload for each event type and include the version in the body. Add fields without removing old ones, and treat any removal or rename as a new version so live workflows keep parsing what they were built against.

  4. 4

    Bound the wait for workflows that respond synchronously. Apply a short connect and read timeout, treat anything past it as an unacknowledged delivery, and never hold a user-facing request or a job worker open waiting on someone else's server.

  5. 5

    Reuse the shared outbound delivery pipeline from the Zapier Trigger Webhook brief for queueing, retry, logging, and auto-disable. This brief owns only the SSRF checks, the shared-secret signing option, and the synchronous-response handling.

Edge cases it handles

8
  • A self-hosted URL is the most direct route to server-side request forgery this app will ever offer. Validate the scheme and resolved address on every attempt, not once at save time, because DNS can be repointed at an internal host afterwards.
  • Not every user will configure a secret, and an unsigned payload cannot be trusted by the receiver. Support an optional shared secret, make its absence visible in the settings screen as a reduced-assurance state, and allow rotating it without recreating the integration.
  • A workflow written against last quarter's payload will break on an unannounced field change. Keep schemas versioned, publish the current version in the body, and keep at least one prior version working through a stated deprecation window.
  • A workflow that responds synchronously can hang for as long as its slowest node. Enforce a timeout, release the worker, and record the delivery as sent-but-unacknowledged rather than blocking the app indefinitely.
  • Retrying a delivery whose workflow already ran can duplicate side effects such as sending a message or charging a customer. Retry only where the delivery was not acknowledged, carry a stable delivery identifier so the workflow can deduplicate, and do not retry a workflow that returned a definitive rejection.
  • A self-hosted instance behind a home connection will be intermittently unreachable. Back off with jitter, cap the retry window, and disable the destination after a sustained run of failures with a clear message to the owner.
  • A user-supplied host may present an invalid or self-signed certificate. Require a valid chain by default, and if an override is offered at all, scope it to the single destination and make the reduced security explicit.
  • When n8n is unavailable, the app must continue working normally. Show the integration as degraded with the last successful delivery time, and never surface the third party's failure as an error on the user's own action.

Definition of done

8
  • Destination hosts are resolved and validated on every attempt, and internal-network targets are refused.
  • An optional shared secret signs the payload with a timestamp, and can be rotated in place.
  • Payload schemas are versioned, the version travels in the body, and prior versions keep working through a deprecation window.
  • Synchronous workflows are bounded by a timeout that never blocks a user request or holds a worker open.
  • Only unacknowledged deliveries are retried, and each carries a stable delivery identifier.
  • An unreachable n8n instance leaves the app fully usable and the integration visibly degraded.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.