Circuitry Logo
Circuitry
Open Circuitry

Adding & Connecting Nodes

A workflow is a set of nodes wired together. You build it by dragging nodes onto the canvas and connecting them in the order you want them to run.

Drag a node onto the canvas

  1. Open the node palette on the left of the workflow editor.
  2. Find the node you want — nodes are grouped (Agents, Code, Logic, Integrations, and more).
  3. Drag it onto the canvas and drop it where you'd like it. The node appears, ready to configure.

Tip: prefer the keyboard? Press Space on the canvas to open a quick node search, type a name, and press Enter to drop it.

Add an integration (hundreds of services)

Integrations work the same way, with one extra step so the catalog can stay tidy:

  1. Click Browse Integrations (the box icon by the Plugins section), or drag a service from the palette.
  2. An operation picker opens with two tabs — Actions (do something) and Triggers (start a workflow when something new appears).
  3. Pick an operation. It drops onto the canvas and its configuration panel opens automatically.

See Integrations & Plugins for the full guide.

Connect nodes

Every node has connection points on its four sides. To connect two nodes:

  1. Hover a node — its connection dots appear.
  2. Drag from one node's edge to another node. An arrow is drawn showing the direction data flows.
  3. Data from the first node becomes available to the second.

Connections define execution order: a node runs after the nodes feeding into it have finished. You don't pick which side to connect to — Circuitry routes the arrow to the nearest sensible edge automatically.

Some nodes start a flow (the Start node and integration triggers). These have no input connector — you can't connect anything into them, because they're the beginning.

Configure a node

Click a node (or double-click) to open its configuration panel. There you set its inputs, choose a connection for an integration, and see its output after a run.

Use template variables to pass data from earlier nodes into a field — wrap a path in double curly braces:

{{input.amount}}          a field from the node feeding in
{{input.body.email}}      a nested field

See Template Variables for the full syntax.

Run it

  • Run a single node from its config panel to test it in isolation.
  • Run the whole workflow with the run controls — execution follows your connections, and each node lights up as it runs. Watch results in the Run Log.

Next steps