Webhook Relay Trigger icon

Webhook Relay Trigger

Receive webhooks through Webhook Relay over an outbound WebSocket — no public IP, tunnel or agent, and n8n is never exposed

Webhook Relay Trigger

AI-generated

Summary

Receives incoming webhooks through a Webhook Relay bucket and emits each event as an n8n item over an outbound WebSocket. Configure the bucket and optional endpoint authentication and immediate response; provide the generated Public URL to the webhook sender.

Inputs

  • Bucket (required) — Bucket name in Webhook Relay; created if it does not exist.
  • Public URL — Load or refresh this field to create or find the bucket input and get its URL for the webhook provider. The URL is also logged on activation.
  • Endpoint Authentication — Choose None, Basic Auth, or Token (Header) for callers to the public endpoint. Basic Auth uses Username and Password; Token requires a Token sent in the Authorization header. Authentication is applied to the bucket.
  • Response Status Code — Status code Webhook Relay returns immediately to the sender; defaults to 200.
  • Response Body — Static text, JSON, or XML body returned immediately to the sender; defaults to empty and is limited to 250 KB.

Output shape

A stream of n8n items, one per received webhook. Each item contains meta, headers, query, body, and method.

String bodies that parse as JSON are emitted as parsed values; other bodies remain strings. Query parameters are emitted as a key/value object. Activation creates or reuses the bucket and input, creates or reuses an internal output named n8n with destination http://localhost, then subscribes to that output. Deactivation closes the WebSocket without deleting resources.

Links

Discussion