Docs »

Automations »

Triggers »

webhook.respond

webhook.respond automations are triggered by a webhook listener that receives an HTTP request.

This trigger uses event handler KATA, and the first enabled automation is executed.

Inputs

The automation dictionary starts with the following values:

Key Type Notes
request_body string The request body as text.
request_client_ip string The client IP making the requst (e.g. 1.2.3.4).
request_headers dictionary The request headers. Keys are lowercase with dashes as underscores (e.g. content_type).
request_method string Method name in uppercase (e.g. POST).
request_params dictionary The query string parameters. Keys are lowercase with dashes as underscores (e.g. query_string).
request_path string The request path (e.g. some/folder/file.ext).

Outputs

return:

Key Type Notes
body: string The body content to return. Use body@base64: for binary.
headers: dictionary A set of key: value paris (e.g. Content-Type: application/json).
status_code: integer HTTP status code (e.g. 200=OK, 403=Forbidden, 404=Not Found, 500=Error).