Skip to main content
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 into process data through a Receive Message Task. This enables processes to delegate data fetching, transformations, and external system integrations to lightweight workflows without creating subprocesses.
For triggering workflows from UI Flows (without a BPMN process), see the Start Workflow action.

How it works

When a Start Integration Workflow action is triggered:
1

Input data is sent

The input data mapped in the action configuration is sent as start variables to the workflow.
2

Workflow executes

The integration workflow runs with the provided inputs, executing its configured nodes (REST calls, data transformations, AI operations, etc.).
3

Output is captured

Workflow output data is captured in the process instance upon completion, at the location configured on the Receive Message Task’s Data Stream.
4

Process continues

The BPMN process continues to the next node after the workflow completes.
The process waits for the workflow to complete before continuing. To receive output data, you must add a Receive Message Task node after the Send Message Task that triggers the workflow.

Configuration

Selecting a workflow

The workflow search field (Search workflow by name) displays:
  • All workflows within the current app version
  • Any workflows referenced in the app (e.g., via the Library)

Input mapping

Map process variables to workflow input parameters:

Receiving output

To capture workflow output in your process:
  1. Add a Receive Message Task node after the node with the Start Integration Workflow action
  2. In its Data Stream configuration, set the source to Workflow and select the workflow
  3. Choose where the output lands: map each End node’s output with Output Mapping (the default), or turn on Legacy Mapping and set a single Key Name
  4. Subsequent nodes can access the output data at the mapped keys

When to use


Passing data between nodes

How node outputs land in process variables and how downstream nodes read them

Integration Designer

Build and configure integration workflows

UI Flows - Start Workflow

Trigger workflows from UI Flows without BPMN processes

Message Events

Learn about Send and Receive Message Task nodes

Actions Overview

Explore all available action types
Last modified on July 8, 2026