How do I monitor and troubleshoot workflow runs?

Last updated: November 5, 2026

Use workflow runs to monitor what happened when a workflow executed, review step-level details, and troubleshoot failures or unexpected outcomes.

Before you start

  • Open the workflow you want to inspect.

  • Know the approximate time, trigger, or affected record for the run you are investigating.

  • Use a recent controlled test run when validating a new workflow.

Steps

  1. Open Workflows.

  2. Select the workflow you want to review.

  3. Open the Runs area.

  4. Find the run by time, status, trigger, or other available details.

  5. Open the run to view Run Details.

  6. Review each step from left to right.

  7. Check step inputs, outputs, logs, and errors where available.

  8. Identify the first step where data is missing, incorrect, or failed.

  9. Update the workflow draft if the issue requires a configuration change.

  10. Test and publish the corrected version when ready.

Tips

  • Start with the earliest failed or unexpected step rather than the final symptom.

  • Compare a failed run with a successful run when available.

  • Check whether the run used the workflow version you expected.

  • Use test data that matches real trigger payloads when reproducing a problem.

Troubleshooting

  • If no runs appear, confirm the workflow is published and that a matching trigger event occurred.

  • If a run failed, inspect the first failed step and its returned error.

  • If data is blank in a later step, inspect the source step output and variable mapping.

  • If a workflow keeps running unexpectedly, review filters, paths, waits, and loop configuration.