Shapes

Start a flow

When called

Makes the flow callable by other flows, the API and AI agents, with a declared input and output.

Nodes › TriggersOpen in Neblex
Good for
Reusable building blocks
Role
Starts a flow
Find it in
Nodes › Triggers

When to use it

  • Several flows need the same step sequence, such as creating a customer the same way everywhere.
  • An AI agent or an API should run the flow as a tool with a known input.
  • Callers must be refused when they send the wrong shape of record.

Reach for something else when

Example

A Create customer flow declares order_id as its input; three order flows call it and get the same customer record back.

  1. When called
  2. Lookup
  3. Salesforce

How it works

Settings
What this flow does (shown to callers and agents); Input it takes: a JSON Schema each input record must match (empty accepts any record); Records it returns: a JSON Schema every returned record must match (empty accepts any).
Behaviour
A record that does not match the declared input stops the run before any step runs, naming the record and the mismatch. A returned record that does not match the declared output fails the calling step with the mismatch. An agent's flow tool without its own arguments schema uses the declared input as its arguments and the description as the tool's description.
Example
Input {"type": "object", "required": ["order_id"], "properties": {"order_id": {"type": "string"}}}: a Call Flow passing {"order_id": "A-17"} runs; one passing {"id": 17} is refused.
More in the guide

Add it to a flow

  1. Open the flow from Build › Workflows.
  2. Open Nodes and find When called under Triggers. Drag it onto the canvas as the first step.
  3. Connect it to the next step and open its settings with ✎ Edit.
  4. Save and test with Run, then set the flow Active so it starts on its own.