Skip to main content

Webhook Trigger

Triggers the workflow via an incoming HTTP call. The request body, headers, and HTTP method are available in the output.

Parameters

ParameterTypeRequiredVariableDescription
pathtextYesNoWebhook URL path. The workflow triggers when this path receives a request. Must start with /. (format: ^/[a-zA-Z0-9\-_/]*$)
methodchoice (GET, POST, PUT, DELETE)YesNoHTTP method accepted by the webhook. (Default: "POST")
authenticationobjectNoNoAuthentication configuration to secure the webhook (none, header with API key, or HMAC-SHA256 signature).
responseModechoice (immediate, wait)NoNoResponse mode: immediate response or wait for workflow completion. (Default: "immediate")
responseCodenumberNoNoHTTP status code returned to the caller. (Default: 200)
responseBodydynamic valueNoYesResponse body returned to the caller. Can be a literal or a variable.
outputVariabletextNoNoOutput variable name containing the incoming request body, headers, and query params.

Parameters marked Variable = Yes accept the {{blockName.field}} syntax.

Output

Output variable : webhookPayload

{
"body": {},
"headers": {},
"method": "..."
}

Example

Receive a webhook notification from an external service.

Input :

{}

Output :

{"body": {"event": "order.created", "data": {"orderId": "ORD-123"}}, "headers": {"content-type": "application/json"}, "method": "POST"}
Tip

Use {{webhookPayload.body}} to access the request body. The webhook path is configured in the block settings.