Workflows
Fix a workflow that failed or didn't run
Fix workflows that won't publish, don't run, stop with an error, or wait longer than expected.
Start with the run when there is one: its page says what happened and what to do. When there's no run at all, start with the workflow.
The workflow won't publish
Select N to finish in the builder header. Before you publish lists each step that needs attention, such as "Choose what starts this workflow" or "Fill in: Subject". Select an item to open that step.
The workflow didn't run
| Check | What to look for |
|---|---|
| Is it on? | Only published workflows that show On can run. |
| Did the event really happen? | Open the record, such as the form answer or invoice, and check it matches the starting point and its settings. |
| Was it a resend? | Workflows started by an invoice or document being sent run on the first send only. |
| Is the feature on? | The area behind the starting point, such as Scheduling or Smart Flows, must be turned on in Settings › Modules. |
| Is it a schedule? | Check Trigger settings for the next run and time zone. |
A run failed
- Open Automations › Workflows › Runs and select Failed.
- Open the run. The top says where it stopped and why, such as "This run stopped at Send your booking link".
- Fix the cause using the table below.
- Check what the run already did, then select Retry run.
| Message | What to do |
|---|---|
| A step is set up wrongly, or something it used was deleted | Open the workflow, fix or replace the step, and publish again. New runs use the fix. |
| "This email was not sent because no mailbox is connected." | During your trial, workflow emails need the owner's connected mailbox. Connect a mailbox, then retry. |
| A connected app is disconnected | Reconnect it in Settings › Apps, then retry. |
| The client has no email address | Add it to the record, then retry. |
You're done when the new run shows Completed or Waiting.
Good to know
- Retry run starts again from the beginning as a new run, with the same record and the same version of the workflow. Steps before the failure run again, so an email that already went out is sent again.
- A Waiting run isn't stuck. It says what it's waiting for. If it shouldn't continue, select Cancel run. If it's waiting for a decision, decide it on the Approvals tab.
- Too many runs, or the same email twice? Check whether two workflows react to the same event, narrow the starting point, and check the list a Repeat for each item step uses.
- To get help, use Copy run ID on the run page and send it with the workflow's name and the exact message.