Condition block

The Condition block (type: "condition") tests values from the run and sends it down one of two branches: then when the test is true, else when it is false. For the plain-language guide, see Make a decision.

When to use it

• Route a bill over an approval limit to an Approval step.
• Skip a step when an earlier lookup found nothing, for example create a customer only when the search returned no match.
• Stop on an error path: point else at a step with terminal: true.

Configuration

In the editor you build the test as rows in Conditions and join them with Combine With (AND or OR). The branches are the connections you draw from the block. On save, the editor writes this config:

Expression forms

left and right are strings. Each can be a literal or a template reference such as {{steps.extract_bill.structured.total}}, resolved before the comparison.

Operators

How branches run

Top-level steps run in array order. Steps listed in then or else run from the condition. The branch not taken is marked skipped, together with any steps nested inside it. A step listed in both branches, or reached again from another branch, runs when a taken path reaches it.

Output

Read the result as {{steps.<step id>.result}}.

Example

This workflow creates a QuickBooks bill and asks the controller to approve bills of $10,000 or more first.

{
  "name": "Approve large bills",
  "trigger": { "type": "api" },
  "steps": [
    {
      "id": "check_amount",
      "type": "condition",
      "name": "Bill is $10,000 or more?",
      "config": {
        "conditions": { "left": "{{input.amount}}", "operator": "gte", "right": "10000" },
        "then": ["controller_approval"]
      }
    },
    {
      "id": "controller_approval",
      "type": "approval",
      "name": "Controller approves bill",
      "config": {
        "approvers": ["controller@example.com"],
        "reason": "Bill {{input.billNumber}} from {{input.vendorName}} for {{input.amount}}",
        "timeout": "3d",
        "notifyChannels": [
          { "type": "email", "instructions": "Write a short note asking the controller to approve this vendor bill." }
        ]
      }
    },
    {
      "id": "create_bill",
      "type": "action",
      "name": "Create bill in QuickBooks",
      "action": "quickbooks.createBill",
      "config": {
        "vendorId": "{{input.vendorId}}",
        "billNumber": "{{input.billNumber}}",
        "lines": "{{input.lines}}"
      }
    }
  ]
}

Bills under $10,000 skip the approval and go straight to create_bill. A rejected approval fails the run, so the bill is not created.

Errors and limits

• A config without conditions or with an empty then fails the step with Invalid condition step config.
• A reference that resolves to nothing compares as empty: exists is false, and gt against it treats it as 0. Test with exists first when a field can be missing.
• In the editor, a condition with no rows saves as a comparison of two empty values, which is true.