Helper Flow

On-demand flow triggered by other flows. Acts like a function — receives input from the caller, processes it, returns output.

Unlike Telegram, webhook, or schedule events, a Helper Flow has no external trigger. It runs only when another flow invokes it via a Flow Control function.

Creating a Helper Flow

  1. Create a new flow
  2. Select Helper Flow as the event
  3. Click + Add output on the event block to define the input parameters the caller will provide
  4. Add actions and functions to process the data
  5. Save and enable

How It's Called

Helper flows are invoked by Flow Control functions:

FunctionDescription
Call FlowRun the helper flow once, wait for the result
Call Flow AsyncRun without waiting
For EachRun once per item in a list
For Each — Ignore ErrorsSame as For Each, but continues if one iteration fails
RepeatRun N times with an index counter
Filter CustomRun as a filter test per list item

Data Flow

  1. The caller defines input values that map to the helper flow's event outputs.
  2. In For Each, the Item block represents the current list item.
  3. Drag Item into the helper flow's input fields.
  4. Each iteration creates a separate execution history entry.

Item Block

In For Each, the blue → Item block appears in the "With the following values" section. Drag it to any input field — it represents the current list item for each iteration.

Per-Iteration History

Each For Each iteration creates a separate execution entry in the helper flow's history. You can inspect:

  • What data was passed (event outputs with real values)
  • What each block produced
  • Whether it succeeded or failed

Concurrency

Set concurrency to control parallel execution:

  • 0 — sequential (one at a time)
  • 1+ — parallel (multiple items at once)

Example: Process Each User

  1. Main flow: get a list of users → For Each → select a helper flow.
  2. Helper flow event outputs: userId, action.
  3. In For Each: drag Item into userId, type "notify" in action.
  4. Helper flow: send a Telegram message to each userId.