Call workflow node

​

Configuration

• id: Unique node identifier
• workflow_id: ID of the workflow to call
• workflow_name: Display name of called workflow (read-only)
• save_error_to: Variable name to store error details if child workflow fails (optional, defaults to subworkflow_error)

​

How it works

1. Creates child execution: Starts a new execution of the called workflow with copied context
2. Pauses parent: Parent workflow enters waiting state until child completes
3. Merges variables: When child finishes, its variables merge into parent’s vars
4. Handles errors: If child fails, error details saved to configured variable
5. Continues execution: Parent resumes from next step after child completes

​

Execution context

• Copy of parent’s vars (workflow variables)
• Copy of parent’s system variables
• Copy of parent’s context (phone_number, channel, etc)
• Same WhatsApp conversation if applicable

​

Error handling

{
  "error": "Workflow call cycle detected",
  "workflow_id": "abc123",
  "workflow_name": "Order Processing",
  "call_stack": ["flow1", "flow2", "flow3"]
}

• Cycle detection: Workflow calls itself directly or indirectly
• Max depth exceeded: Call stack exceeds 10 levels
• Non-executable workflow: Called workflow is not published/active
• Insufficient credits: Not enough credits to execute child workflow

​

Safeguards

• Detects circular calls (workflow A → workflow B → workflow A)
• Maximum call depth of 10 workflows (prevents infinite recursion)
• Errors stored in variables instead of failing entire workflow

• Each call creates independent execution record
• Parent and child executions visible in execution history
• Child execution shows in parent’s execution stack

​

Usage patterns

​

Execution stack

{
  "id": "parent_exec_123",
  "flow": { "name": "Main Workflow" },
  "execution_stack": [
    {
      "id": "parent_exec_123",
      "flow": { "name": "Main Workflow" },
      "status": "waiting",
      "current_step": { "identifier": "call_order_validation" }
    },
    {
      "id": "child_exec_456",
      "flow": { "name": "Order Validation" },
      "status": "running",
      "current_step": { "identifier": "check_inventory" }
    }
  ]
}

​

Best practices

​

Workflow library example

workflow.addNode("run_support_flow", {
  type: "call",
  workflowSlug: "support-flow",
  saveErrorTo: "support_flow_error"
});