Agentiff Webhook icon

Agentiff Webhook

Webhook trigger with automatic Agentiff.AI parameter extraction and authentication.

Agentiff Webhook

AI-generated

Summary

Receive and process HTTP POST requests at a configurable webhook URL path, automatically extracting standard Agentiff.AI fields and any user-defined parameters from the webhook body, with optional validation and inclusion of request headers and query parameters. Respond according to the selected response mode and output a structured JSON object containing extracted data and the original request details for use in downstream workflow nodes.

Inputs

  • Path (required) — The URL path for the webhook to listen on (e.g., "agentiff-webhook").
  • Response Mode (required) — Determines when and how to respond to the webhook call: immediately on receipt, with data from the last executed node, or via a separate 'Respond to Webhook' node.
  • Auto-Extract Standard Fields (required) — Whether to extract execution_id, api_token, inputs, credentials, and prompts fields automatically from the incoming webhook body, flattening inputs.* for ease of access.
  • Extract Parameters — A collection of additional parameters to extract from the webhook body, specifying their name, output key, expected type, default value, and whether they are required.
  • Options — Additional processing options: validate the Agentiff.AI request signature, include request headers in output, and include URL query parameters in output.

Output shape

a single JSON object containing extracted parameters, original webhook body, and optionally headers and query parameters

Output always includes a 'body' field with the original request body. If autoExtract is enabled, standard Agentiff fields are extracted and flattened. Custom parameters can be defined for extraction enforcing type and required flags, with error responses returned on missing required or invalid JSON parameters. Inclusion of headers and query parameters in the output is optional. The response to the webhook call respects the configured response mode.

Examples

Example 1: Handling an Agentiff.AI webhook POST request with automatic extraction and custom parameter extraction

Set Path to 'agentiff-webhook', Response Mode to 'Response Node', Auto-Extract to true, define additional parameters to extract (e.g., 'user_id' as string required). Enable Validate Signature for security, optionally include headers and query parameters in output to downstream nodes.

Links

Discussion