ZyanDocs

Automations overview

What an automation is, the four states a definition can be in, how runs are recorded, and the one rule that explains most confusion — nothing runs until you enable it.

An automation is one trigger — the event that starts it — plus a graph of steps that follow. It replaces the jobs somebody currently does by hand five minutes after a form comes in. The page subtitle states the only rule that really matters: Trigger-driven workflows. Nothing runs until you enable it.

Before you start

Automations needs the Automations plan feature and the automations permission — view to see them, create/edit to change them. Owners bypass the permission.

Edit the draft

Save draft changes nothing live

Enable or Publish changes

The only step that goes live

Published graph

A frozen copy of the draft

Dispatcher

Runs that copy on every trigger

Runs tab

Each firing, step by step

The dispatcher never reads your draft. Until you publish, the top bar reads Draft differs from live and the old graph keeps running.
The Automations list showing five automations with their status, trigger, step count and run history
Status decides whether anything happens at all — a draft never fires, however finished it looks. The Runs column is the fastest check that one is actually working.

The three tabs

Open CRMAutomations.

TabWhat it holds
AutomationsYour live and draft definitions, with status and run counts
ArchivedParked definitions, with Un-archive
RunsThe ledger of recent runs, with each step's status

Both the definitions list and the run ledger have a Status filter — All statuses, Enabled, Draft, Paused on the first; run statuses on the second.

Draft, enabled, paused, archived

StateWhat it means
DraftSaved, not running. A draft can be edited freely
EnabledThe published graph is live and the dispatcher runs it
PausedLive but not firing
ArchivedParked. Un-archiving returns it to Draft, never straight to Enabled

Saving a draft never changes live behaviour

What the dispatcher runs is the published graph — a frozen copy taken when you click Enable or Publish changes. Editing and saving a live automation does nothing to what is actually running until you publish. The top bar says Draft differs from live when the two have diverged.

Runs

Every firing is recorded in the Runs tab with its step statuses, so you can see which step stalled rather than guessing. If a run is missing entirely, the automation did not fire — that is a trigger problem, not a step problem, and the usual cause is that it was never enabled.

Agency scope and client scope

An automation's scope is set when it is created and cannot change afterwards. Some steps are agency-only: in a client-scoped workflow you will see messages like Slack steps are available for agency workflows only.

Decide the scope before you build

Because scope is immutable, discovering halfway through that your client-scoped automation cannot send the Slack message is a rebuild, not an edit. If the workflow notifies your own team, it is an agency workflow.

Two editors

Automations has two builders. Workspaces with the canvas editor enabled get a graph you lay out visually; the others get the older linear builder. Both produce the same thing — a trigger plus steps — and everything in these pages applies to either, but a screenshot of the canvas will not match every workspace.

Permissions

ActionNeeds
See automations and runsThe automations permission, view level
Create or editThe automations permission, create/edit level
Read the Webhooks tileOwner, or an automations editor with the permission
Manage webhook endpointsOwner or admin
Connect most integrationsOwner or admin

Troubleshooting

SymptomCauseFix
An automation is saved but never firesIt was saved as a draft and never enabledOpen it and click Enable
It fires, but the old behaviourThe draft was saved, not publishedClick Publish changes; the bar reads Draft differs from live
Enable is disabledA step's integration is not connected, or another blockerRead the tooltip on the button; connect the flagged integration
The page says the workflow tables are not provisionedThe environment does not have themIt is not an empty state — contact support
An archived automation came back as a draftUn-archiving always returns to DraftEnable it deliberately
A step is unavailable in a client workflowSome steps are agency-onlyRebuild as an agency workflow — scope cannot change
The editor looks nothing like a colleague'sThe canvas editor is enabled per workspaceBoth editors build the same thing

In this section