Skip to main content

What is a Composer?

A Composer is the top-level orchestrator in Automations. It lets you connect multiple automations and hooks on a visual canvas to define an execution flow. Think of it as the master plan that controls which workflows run and how they chain together.

Creating a Composer

1

Switch to Test Mode

Composers can only be created in test mode. Use the mode toggle in the sidebar if you’re currently in live mode.
2

Click Create

Click the Create button in the composers section of the sidebar.
3

Name Your Composer

Give your composer a descriptive name that reflects its purpose.

The Composer Canvas

When you select a composer from the sidebar, the main area opens the composer canvas — a visual flow editor where you build your orchestration. It works similarly to the Workflow Canvas: steps are nodes, and you connect them with edges to define the execution order.

Trigger Node

Every composer has a Trigger node at the top of the canvas. Click the trigger node to open its configuration panel on the right and set how the composer starts:
Trigger TypeDescription
EventsFires when a specified platform event occurs (e.g. Contract Created)
ScheduleRuns on a cron schedule you define
ManualStarted only by clicking the Run button

Step Types

TypeDescription
AutomationReferences a workflow built on the automation canvas
SleepPauses execution for a specified duration before continuing
ReviewPauses execution and creates a review request with a configurable timeout and message

Adding Steps

Add steps to the canvas in two ways:
  • Header button — Click the Step dropdown in the canvas header and select a step type.
  • Right-click menu — Right-click anywhere on the canvas to open a context menu with all step types.

Connecting Steps

Drag from the output handle of one node to the input handle of another to connect them. The execution flows along these connections. Cycles are not permitted — the canvas prevents you from creating a circular connection.

Configuring a Step

Click any node on the canvas to select it and open its configuration panel on the right side:
  • Automation step — Toggle the step enabled or disabled. Click the drill-in icon on the node to open that automation’s workflow canvas.
  • Sleep step — Set the duration (e.g. 30s, 5m, 1h).
  • Review step — Enter a message for reviewers and a timeout after which the composer continues automatically.

Repositioning Nodes

Drag nodes to rearrange them. The visual layout does not affect execution — only the connections matter.

Removing Steps

Select a node and either press Backspace or click the trash icon in the configuration panel.

Running a Composer

Click the Run button in the canvas header to execute the composer. While running, active nodes pulse to show live execution status. Toggle the Logs panel (the logs icon in the header) to see step-by-step execution output inline.

Managing Composers

Renaming

Click on the composer name in the sidebar to edit it inline.

Deleting

Delete a composer from the sidebar context menu. This removes the composer and all its step references.
Deleting a composer is permanent. The underlying automations are not deleted, but the orchestration flow is lost.

Managing Automations from the Sidebar

When a composer is expanded in the sidebar, the automations it references are listed beneath it. Hover over any automation item to reveal a three-dot menu () with the following actions:
  • Rename — Edit the automation’s name inline. Press Enter to save or Escape to cancel.
  • Delete — Permanently delete the automation and all its steps, connectors, and execution logs. A confirmation dialog is shown before anything is removed.
The three-dot menu is only available in test mode. It is hidden when the composer is live.

Workflow Canvas

Build the automations that composers orchestrate.

Triggers

Configure how composers are started.

Test & Deploy

Test and deploy your composer workflows.

Runs & Logs

Full execution history and log details.