Skip to main content

​
Workflow Runs

Workflow Runs provides comprehensive monitoring and debugging capabilities for all your workflow executions. View detailed logs, track performance, filter by criteria, and retry errored executions.

​
Overview

The Workflow Runs section allows you to:
  • Monitor executions - See all workflow runs in real-time
  • Debug issues - View detailed step-by-step logs
  • Filter and search - Find specific executions quickly
  • Retry runs - Re-execute errored workflows
  • Track performance - Analyze execution times and success rates

​
Accessing Workflow Runs

  1. Navigate to Automations > Workflow Runs in the sidebar
  2. Or access from a specific site via Site > Workflows > Workflow Runs

​
View Options

Global View:
  • Shows all workflow runs across the workspace
  • Filter with Status, Workflow status, Workflows, Contact, and Date range
  • Access from main navigation
Site-Specific View:
  • Shows workflow runs for a specific site
  • Same filters: Status, Workflow status, Workflows, Contact, and Date range
  • Access from the site editor

​
Workflow Run List

​
Run Information Displayed

Each workflow run shows:
  • Workflow Name - Which workflow executed
  • Version - The workflow version the run executed against
  • Status - Success, Errored, In Progress, or Created
  • Start Time - When execution began
  • Duration - How long execution took
  • Trigger - What initiated the workflow

​
Status Types

Success
  • All steps completed successfully
  • No errors encountered
  • Final action executed
Errored
  • One or more steps failed
  • Error details available
  • May require retry or manual intervention
In Progress
  • Currently executing
  • Steps in progress
Created
  • Run record created and waiting to execute
Row actions on a run include View and, for Errored runs, Retry.

​
Available Filters

Date range:
  • Date-range selector for when runs started
  • Defaults to the last month
  • Includes a From Start option
Status:
  • Success
  • Errored
  • In Progress
  • Multiple selection allowed
Workflow status:
  • Filter by the workflow’s lifecycle status
Workflows:
  • Filter to one or more specific workflows
Contact:
  • Filter runs related to a specific contact
Version:
  • Filter runs by the workflow version they executed against
  • Select one or more versions to narrow results
  • Available when viewing runs for a specific workflow

​
Using Filters

  1. Click Filter button
  2. Select filter criteria
  3. Apply filters
  4. View filtered results
  5. Clear filters to reset

​
Filter Chips

Active filters display as chips:
  • Click X to remove individual filters
  • Click Clear All to remove all filters
  • Filters persist in URL for sharing

​
Viewing Run Details

​
Execution Log

Click any workflow run to view detailed execution log. Run details are loaded fresh each time you open them to ensure you see the latest data. Overview Section:
  • Workflow name and ID
  • Version name and number for each attempt
  • Contact information
  • Start and end times
  • Total duration
  • Final status
  • Trigger information
Step-by-Step Log: Each workflow step shows:
  • Step Name - Action performed
  • Status - Success or failed
  • Timestamp - When step executed
  • Duration - How long step took
  • Input Data - Data received by step
  • Output Data - Data produced by step
  • Error Details - If step failed

​
Step Types Displayed

Triggers:
  • Trigger type and conditions
  • Contact or event that triggered workflow
  • Timestamp of trigger
Actions:
  • Action performed (email, tag, etc.)
  • Target contact or entity
  • Success/failure status
  • Result details
Conditions:
  • Condition evaluated
  • Result (true/false)
  • Branch taken

​
Debugging Errored Runs

​
Identifying Issues

Errored status:
  1. Locate the errored run in the list
  2. Click to open details
  3. Review step-by-step log
  4. Identify the failed step
  5. View the error message

​
Common Failure Reasons

Configuration Errors:
  • Missing required fields
  • Invalid email addresses
  • Incorrect API credentials
  • Deleted resources referenced
Data Issues:
  • Missing contact properties
  • Invalid data formats
  • Null values where required
  • Data type mismatches
External Service Failures:
  • Email service unavailable
  • API timeouts
  • CRM sync failures
  • Webhook errors
Logic Errors:
  • Infinite loops
  • Missing condition branches
  • Invalid variable references
  • Timing issues

​
Error Details

Each failed step shows:
  • Error Code - Machine-readable error identifier
  • Error Message - Human-readable description
  • Stack Trace - Technical details (for advanced debugging)
  • Input Data - Data that caused failure
  • Suggested Fix - Recommended resolution

​
Replaying Workflow Runs

​
When to Replay

Appropriate Scenarios:
  • Temporary external service failure
  • Configuration since corrected
  • Data issue now resolved
  • Testing workflow changes
Not Appropriate:
  • Contact no longer exists
  • Workflow logic fundamentally changed
  • Duplicate action concerns
  • Compliance restrictions

​
How to Replay

  1. Open the workflow run details
  2. Click Retry workflow run
  3. Choose whether to use the current published version (see below)
  4. Confirm to re-run the workflow
  5. The new run appears in the list with the original trigger data
  6. Compare original vs. replay results

​
Replay Options

When you retry a workflow run, the original trigger data and contact are reused so the run starts from identical conditions. You can choose which workflow version executes: Replay with the original version:
  • Re-runs against the same workflow version that was used in the original execution
  • Useful when verifying behavior of a specific historical version, or when the published version has not changed
Replay with the current published version:
  • Available when a newer published version exists than the one originally executed
  • Enabled by default via the Re-run using current published version (<version>) checkbox in the retry confirmation modal
  • The version label shown in the checkbox reflects the current published version name or number, so you can confirm which version will run before retrying
  • Useful when the original failure was caused by a workflow logic issue that has since been fixed in a newer published version
  • If no newer published version exists, the checkbox is hidden and the retry uses the original version

​
Monitoring tips

Use the Workflow Runs list and step detail view to spot problems early:
  • Check Errored runs regularly and open the step log for the failure
  • Watch for workflows that stay in In Progress longer than expected
  • After fixing a workflow, use Retry on an errored run with Re-run using current published version when a newer published version exists
  • On the workflow Overview, review the available success-rate summary for that workflow

​
Best Practices

​
Monitoring

Regular Review:
  • Check errored runs daily
  • Review runs that stay in progress unexpectedly
  • Monitor success trends on the workflow Overview
Proactive Debugging:
  • Test workflows before publishing
  • Validate with sample data
  • Monitor initial runs closely

​
Troubleshooting

Investigation Steps:
  1. Identify failure pattern
  2. Review recent changes
  3. Check external services
  4. Validate data quality
  5. Test in isolation
  6. Implement fix
  7. Monitor retry
Documentation:
  • Note common issues
  • Document solutions
  • Share with team
  • Update workflow comments

​
FAQ

Q: What’s the difference between replay and clone? A: Replay (Retry workflow run) re-executes a previous run using the original trigger data, optionally against the current published version of the workflow. Clone creates a copy of the workflow definition for editing. When you clone a workflow, a confirmation modal lets you enter a custom name for the new copy (max 50 characters). The cloned workflow is created in Draft status so you can modify it before activating. Q: Can I replay a workflow run against the latest published version? A: Yes. When you retry an errored workflow run and a newer published version exists, the retry confirmation modal shows a Re-run using current published version checkbox (with the version label). Leave it checked to execute against the current published version, or uncheck it to re-run against the original version that was used at the time of the failed run. Q: Can I see workflow runs from deleted cards or sites? A: Yes, workflow runs are retained even if the triggering card or site is deleted, for historical analysis. Q: Can multiple people view workflow runs simultaneously? A: Yes, workflow runs are visible to all workspace members with appropriate permissions.
Need Help? Contact [email protected] for workflow debugging assistance.