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
WebhookWhen another system calls in over HTTP with no declared contract.Run another flowWhen you are building the flow that calls this one.
Example
A Create customer flow declares order_id as its input; three order flows call it and get the same customer record back.
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.
Add it to a flow
- Open the flow from Build › Workflows.
- Open Nodes and find When called under Triggers. Drag it onto the canvas as the first step.
- Connect it to the next step and open its settings with ✎ Edit.
- Save and test with Run, then set the flow Active so it starts on its own.
More in Start a flow
WebhookStarts the flow the moment another system calls its address.Nodes › TriggersForm (starts flow)Starts the flow when someone submits a form, with their answers as the input.Nodes › TriggersScheduleRuns the flow on a repeating interval or at set times.Nodes › TriggersPoll for changesChecks a system regularly and starts a run only for records that are new or changed.Nodes › TriggersLive streamSubscribes to a queue, topic or stream and runs the flow for each message as it arrives.Nodes › TriggersWhen an API operation is calledStarts the flow when its operation of a published API is called, with the call as its record.Nodes › Triggers