Loops & Branching

Loops and branching let you handle lists of data and run multiple paths in parallel.

Loop Steps

A Loop step takes a list of items and runs the downstream steps once for each item. This is how you process collections — for example, sending an email to every customer in a filtered list.

How It Works

Connect a step that outputs a list (like a Filter or Query step) to the Loop step's input.
Connect the Loop step's output to the steps you want to repeat.
Inside the loop, each iteration receives one item from the list as its input.

Example

Filter all customers in a zone → Loop over each customer → Send a personalized email to each one.

Configuration

List input — Select which upstream output contains the list to iterate over.
Iteration variable — The name used to reference the current item inside the loop (defaults to "item").

Split & Merge (Parallel Branches)

A Split step divides the workflow into multiple parallel branches that run simultaneously. A Merge step combines them back together.

When to Use Split

Use Split when you have independent actions that do not depend on each other and can run at the same time:

Send an email AND an SMS simultaneously after a booking confirmation.
Update the calendar AND create an invoice at the same time after job completion.
Call two different APIs in parallel and combine the results.

How It Works

Add a Split step where you want branches to diverge.
Connect each branch to its own chain of steps.
Add a Merge step at the end of the parallel branches to combine them.

Merge Configuration

Wait for all — The Merge step waits until every incoming branch has completed before passing data downstream.
Output mapping — Define how to combine data from the different branches into a single output.

Tips

Loops are sequential by default — each iteration completes before the next starts.
Use Split/Merge to speed up workflows with independent steps.
Be careful with loops over large lists — each iteration runs the full downstream chain, so a list of 1,000 items means 1,000 runs of every connected step.