Working on the flow canvas
Step by step — add steps, connect them, configure each one, use data placeholders, save, test and read the execution.
1. Open or create the flow
/flows → New flow (name, purpose, trigger type) or Edit on an existing one. The canvas opens with a Source step: every traveller enters there.
2. Add steps
Drag a step type from the palette onto the canvas, or click one to drop it near the selected step. Each step shows its inputs on the left and outputs on the right. The full list is in Step types.
3. Connect them
Drag from an output to the next step's input. A step with two outputs (a condition, a split test, a register step) needs both connected, or the second path ends the run. Delete a line by clicking it.
4. Configure a step
Click a step to open its settings. Every text field accepts a placeholder that reads the traveller's data:
{{data.email}}— a value collected earlier{{data.order.total}}— nested values{{data.webhook.json.id}}— what an inbound webhook posted
The Set data step is where you compute a value once and reuse it by name.
5. Save and test
Save writes the flow. Run it yourself: open the page URL for a web flow, post to the webhook address for a webhook flow, or use Run now for a scheduled one. Then open /executions and read the run step by step — the data at each step, and the first error if one stopped it.
6. Waiting steps
A delay, async wait or agent invoke step parks the traveller. You will find it in /travellers with what it is waiting for; the engine resumes it when the wait ends.
Common mistakes
- A condition with only the true output connected: false runs end silently. Connect both.
- A placeholder for data that no earlier step collected: it renders empty. Check the execution's data view.
- Editing a flow that has travellers in flight: they continue on the steps they were on; new steps apply to new travellers.