Nested Workflow

Task type: Nested Workflow

Use Nested Workflow to call another workflow as a reusable subroutine from the current workflow.

Run behavior

• Side effects: This task is read-only or computation-only by default. It returns data for later steps rather than directly writing records or sending messages.
• Credit usage: This task is not classified as credit-billed by the workflow task registry.

When to use this task

• Reuse a proven workflow inside a larger process.
• Keep a complex workflow readable by splitting it into smaller workflows.
• Call a workflow and wait for outputs before continuing.

Setup tips

• Map every required child workflow input explicitly.
• Decide whether the parent needs to wait for child outputs.
• Keep the child workflow input/output contract small and stable.

Examples

Reusable account enrichment

Call a shared account enrichment workflow from several different trigger-driven workflows.

Outputs

• Nested workflow execution result and any child workflow outputs when awaited.

Common pitfalls

• Changing child workflow inputs without updating parent mappings.
• Using nested workflows when a single task would be clearer.
• Forgetting that child workflow side effects still run for real.

Reference details

These details are generated from the workflow task registry and match the fields available in the builder.

Required fields

• workflowId
• executionMode

Variable-aware fields

Fields that accept variable references ({{ inputs.x }}, {{ steps.N.y }}) from the workflow's variable graph:

• inputs

Liquid template fields

Fields that are rendered through Liquid (variables plus filters and control flow):

• inputs

Builder guidance

When the Workflow Builder Genie configures this task, it follows this guidance:

Map every required nested workflow input explicitly and decide whether the parent must await results.

Default configuration

New instances of this task start with the following configuration:

{
  "name": "Nested Workflow Task",
  "outputKey": "nested_workflow_task",
  "taskType": "Nested Workflow",
  "description": "",
  "workflowId": "",
  "executionMode": "trigger_and_await",
  "inputs": {}
}