The Start Integration Workflow action is available on Send Message Task, Task, and User Task nodes within BPMN processes.
Overview
The Start Integration Workflow action allows a BPMN process to trigger an integration workflow, send input data, and receive the workflow output at a designated result key. This enables processes to delegate data fetching, transformations, and external system integrations to lightweight workflows without creating subprocesses.How it works
When a Start Integration Workflow action is triggered:Input data is sent
The input data mapped in the action configuration is sent as start variables to the workflow.
Workflow executes
The integration workflow runs with the provided inputs, executing its configured nodes (REST calls, data transformations, AI operations, etc.).
Output is captured
Workflow output data is captured on the specified result key in the process instance upon completion.
Configuration
Selecting a workflow
The Select Workflows dropdown displays:- All workflows within the current application version
- Any workflows referenced in the application (e.g., via the Library)
Input mapping
Map process variables to workflow input parameters:Result key
Configure the result key where workflow output data will be stored in the process instance variables after completion.Receiving output
To capture workflow output in your process:- Add a Receive Message Task node after the node with the Start Integration Workflow action
- The workflow output is automatically mapped to the configured result key
- Subsequent nodes can access the output data via the result key path
When to use
| Scenario | Recommended Action |
|---|---|
| Call external APIs and return data | Start Integration Workflow |
| Run data transformations | Start Integration Workflow |
| Execute AI operations (extraction, generation) | Start Integration Workflow |
| Multi-step user journeys | Use subprocesses instead |
| Processes requiring state management | Use subprocesses instead |