Trigger Network

On Incoming Webhook

Listens for HTTP POST requests on a port and path, which trigger the pipeline.

Node IDWebhookTrigger

Parameters

Parameter	Type	Required	Default	Description
Bind IP `bind_ip`	`string`	Yes	`0.0.0.0`	IP to listen on. '0.0.0.0' for network access, '127.0.0.1' for local only.
Port `port`	`integer`	Yes	`0`	Network port to listen on. '0' will automatically find a free port. Webhook triggers in any deployed graph that set the same Bind IP and the same non-zero port share one server, so their Webhook Paths must differ.
Webhook Path `webhook_path`	`string`	Yes	`/webhook`	The path for the URL (e.g., /my-hook). Must start with a '/'.
Require Authentication `requireAuth`	`boolean`	No	`false`	If enabled, incoming requests must include a valid Bearer token in the Authorization header.
Auth Secret Key `authSecretKey`	`string`	No	—	The name of the secret in the vault to use for authentication. Required if 'Require Authentication' is enabled.
Body Mode `body_mode`	`enum` `json` `text` `multipart`	No	`json`	How to parse the incoming request body. 'json' expects application/json, 'text' reads raw UTF-8, 'multipart' parses multipart/form-data file and field uploads.
Queue Events `queue_events`	`boolean`	No	`false`	Queue webhook events until the previous workflow finishes, including all branches. When off, workflow executions may overlap. Synchronous response timeouts include time spent in the queue.
Response Mode `response_mode`	`enum` `fire_and_forget` `synchronous`	No	`fire_and_forget`	'fire_and_forget' returns immediately (existing behavior). 'synchronous' holds the HTTP connection open until a WebhookRespondAction node fires in the pipeline.
Response Timeout (ms) `response_timeout_ms`	`integer`	No	`30000`	How long (in milliseconds) to wait for the pipeline to produce a response before returning 504, including any time spent in the event queue. Only relevant in synchronous mode. A timeout does not cancel the queued event or workflow.
Max Body Size (bytes) `max_body_size_bytes`	`integer`	No	`10485760`	Maximum allowed request body size in bytes. Set to 0 for no limit. Default is 10 MB.
Max Concurrent Requests `max_concurrent_requests`	`integer`	No	`0`	Maximum number of requests processed concurrently. Set to 0 for no limit.
Max Open Sync Responses `max_registry_size`	`integer`	No	`0`	Maximum number of synchronous responses held open at once. Set to 0 for no limit. Only relevant in synchronous mode.

Outputs

Output	Type	Identifier	Description
On Webhook Received `output0`	`object`	`webhook_payload`	Fired when a request is received. Emits a data object containing the request body.