For the complete documentation index, see llms.txt. This page is also available as Markdown.

Agentic Workflow Integration Actions

Overview

Integration actions connect Agentic Workflows to systems and services outside of Kizen. Use them to send data to external APIs, trigger processes in third-party platforms, and apply AI-powered processing to Records, files, and audio content. Integration actions extend the reach of an Agentic Workflow beyond the Kizen data model to the broader technology stack.

Note: For error handling, see Agentic Workflow Error Handling.


External HTTP Requests

The External HTTP Requests action sends an outbound HTTP request to an external URL.

Choose Custom HTTP Action: Select the HTTP method using the method buttons: GET, PUT, POST, PATCH, or DELETE.

Request URL: Enter the destination URL in the Request URL field. Use + INSERT MERGE FIELD to embed dynamic values, such as a Record ID, execution ID, or field value, directly in the URL.

Data Payload: For methods that support a request body (PUT, POST, PATCH, DELETE), a Data Payload field is available. Enter the payload content in the body area.

  • The placeholder text reads Enter Data Payload in JSON, XML, etc., indicating that any format is accepted.

  • Use + INSERT MERGE FIELD to insert dynamic values into the payload. The Encode Merge Fields toggle (enabled by default) automatically encodes special characters in resolved merge field values to prevent malformed payloads.

Content-Type: Use the Content-Type dropdown to set the Content-Type header for the request. The following are commonly used formats that are available:

  • application/javascript

  • application/xml

  • application/xhtml+xml

  • application/json

  • text/html

For other file types, reference your integrations documentation.

Customize Header (Parameters and Values): Use + ADD PARAMETER to add custom key-value pairs to the request headers.

Response and error behavior: The External HTTP Requests action is outbound only; the response payload from the external system is not returned to the Agentic Workflow and cannot be accessed in subsequent steps. As noted in the UI: anything other than 200- and 300-class responses is treated as an error.

Note: If you need to use the response data from an HTTP call in subsequent steps, use a Code Step instead. Code steps can send the request and process the response within a single step, making the response data available for downstream logic. See Agentic Workflow Code Steps.

Rate limiting behavior: When the external system returns a 429 (Too Many Requests) response, the action automatically retries.

  • The retry wait time is taken from the value specified in the throttle response if present; otherwise, exponential backoff is applied. The system retries up to a limited number of times before treating the step as failed.


Key Use Cases

Integration actions are applicable across any Workflow that requires data exchange with external systems or AI-powered processing within an automated process. The following examples illustrate common patterns in three industries where external integration is a core operational requirement.

Industry Examples

Insurance operations depend on real-time data exchange with underwriting platforms, claims management systems, document processors, and regulatory reporting endpoints.

Examples include:

  • Using External HTTP Requests to send a POST request to a claims management system when a new claim Record is created in Kizen, passing claim details in a JSON payload with merge fields

  • Using External HTTP Requests to send a PUT request to an underwriting platform to update a policy status when an Agentic Workflowreaches the approval stage

  • Using Call LLM to analyze the content of a free-text adjuster notes field and classify the claim type, writing the result to a classification field for downstream routing

  • Using File Extraction to extract structured data from an uploaded policy document and populate corresponding fields on the policy Record

How integration actions help:

  • Synchronize Kizen Records with external claims, underwriting, and policy administration systems in real time as Agentic Workflows execute

  • Trigger downstream processes in third-party platforms without requiring manual data re-entry or separate integration middleware

  • Apply AI-powered classification and extraction to unstructured data, making it available for routing, reporting, and downstream Agentic Workflow logic

  • Extend Agentic Workflow Workflows beyond the Kizen platform to the full technology stack used across the business


What's Next?

Continue to Messages Actions to learn how to send emails and text messages to Contact Records directly from an Agentic Workflow, including template selection, merge fields, and SMS character limits.

Last updated

Was this helpful?