Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.kapso.ai/llms.txt

Use this file to discover all available pages before exploring further.

Calls an external HTTP endpoint, optionally stores the response, and then advances through the next edge.

Configuration

  • url: HTTP endpoint to call
  • method: HTTP method, defaults to POST
  • headers: Header object
  • body_template: JSON body template
  • save_response_to: Variable name to store the response (optional)
  • provider_model_name: Required when using AIField
  • ai_field_config: AI field-resolution settings

Workflow library example

workflow.addNode("create_ticket", {
  type: "webhook",
  url: "https://api.example.com/tickets",
  method: "POST",
  headers: {
    "X-API-Key": "${ENV:SUPPORT_API_KEY}"
  },
  bodyTemplate: {
    phone: "{{context.phone_number}}",
    message: "{{last_user_input}}"
  },
  saveResponseTo: "ticket"
});

API payload shape

When using the Platform API directly, use snake_case keys:
{
  "node_type": "webhook",
  "config": {
    "url": "https://api.example.com/tickets",
    "method": "POST",
    "headers": {
      "X-API-Key": "${ENV:SUPPORT_API_KEY}"
    },
    "body_template": {
      "phone": "{{context.phone_number}}",
      "message": "{{last_user_input}}"
    },
    "save_response_to": "ticket"
  }
}

Usage patterns

Create CRM record Notify another system