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
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.
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 Type | Description |
|---|---|
| Events | Fires when a specified platform event occurs (e.g. Contract Created) |
| Schedule | Runs on a cron schedule you define |
| Manual | Started only by clicking the Run button |
Step Types
| Type | Description |
|---|---|
| Automation | References a workflow built on the automation canvas |
| Sleep | Pauses execution for a specified duration before continuing |
| Review | Pauses 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.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.
Related Documentation
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.