Skip to main content
The Workflow Runs page is your real-time log of every integration execution inside Lighthouse. Every time a connected app sends an event β€” a new HubSpot deal, an updated contact, a completed order β€” Lighthouse creates a workflow run record that you can inspect, filter, and replay.
Workflow Runs Page
Use this page to answer three core questions:
  • Did my integration run successfully?
  • If something went wrong β€” which step failed and why?
  • Can I replay a run without waiting for the next trigger?

Reading the Runs List

Each row in the table represents a single workflow execution.
ColumnWhat It Shows
ReferenceThe source record that triggered the run β€” e.g. HubSpot Deal ID: 49649660024
IDThe unique numeric identifier for this run β€” e.g. 33222. Always include this in support requests
WorkflowThe integration that executed β€” e.g. HubSpot β†’ Xero Invoice
StatusThe run outcome: Finished, Failed, Running, or Pending
StartedThe date and time the run began executing

Run Status Reference

StatusMeaningWhat To Do
FinishedAll steps completed successfullyNo action needed. Review details if you want to verify outputs
FailedOne or more steps encountered an error and the run could not completeClick Explain for a summary. Click View to inspect the failed step. Retrigger after fixing the root cause
RunningThe workflow is currently in progressWait for it to complete. Refresh the page to see the updated status
PendingThe run is queued and waiting to startNo action needed β€” it will start automatically
SkippedThe run was intentionally skipped based on your workflow logicNo action needed. Skipped runs are expected β€” the workflow evaluated the event and determined no action was required

Row Controls

Every row has three interactive controls on the right-hand side. Together they give you full visibility and recovery capability without leaving the page.
Row Controls

πŸ’¬ Explain

Click the speech-bubble iconGenerates a plain-English AI summary of the run β€” what happened, which step failed, and likely cause. Use this first before reading technical logs.

πŸ‘ View

Click the eye iconOpens the full Workflow Run detail page β€” event payload, step-by-step execution log, duration, and the Re-run button.

β‹― Actions

Click the three-dot menuDropdown with two options: Retrigger (replay the run) and View (same as the eye icon).

πŸ’¬ The Explain Button

Clicking the speech-bubble icon on any row generates an AI-powered plain-English explanation of that run β€” no JSON reading required.
Use Explain first on any failed run. It will tell you which step failed, why it failed, and whether you need to fix something in your source system before retriggering.
The explanation typically covers:
  • Which step succeeded or failed
  • The specific reason for the failure (e.g. a missing required field, an API authentication error, or a duplicate record check)
  • Whether the failure is likely to resolve on retrigger or requires a data fix first
The Explain button is also available on the individual Run Detail page, positioned alongside the step logs so you can read both together.

πŸ‘ The Run Detail Page

Clicking the eye icon β€” or selecting View from the Actions menu β€” opens the full detail view for that run.
Workflow Run Detail Page

Run Metadata Header

The top section shows everything you need to know about the run at a glance.
FieldWhat It Tells You
IDThe unique run identifier. Include this in any support request
WorkflowThe name of the integration that was executed
StatusFinal run state: finished, failed, running, or pending
HubSpot Deal IDThe source record that triggered this run
ModeLive (production data) or Test (sandbox). Shown as a green or grey badge
DurationTotal time taken to complete all steps
CreatedWhen the run record was first created in Lighthouse
StartedWhen Lighthouse began executing the workflow steps
FinishedWhen the final step completed (or failed)
AttemptsHow many times Lighthouse attempted this run β€” useful for identifying retry loops

The Re-run Button

The blue Re-run button in the top-right replays the run using the original stored event payload.
Re-run uses the data captured at the time of the original run. If the source record in HubSpot has been updated since then, Re-run will execute using the old data β€” not the current values. Use Retrigger from the Actions menu if you want to re-fetch the latest record from the source system.

The Event Block

The Event block identifies what triggered this run:
  • Event ID β€” the internal ID of the incoming event that caused the workflow to start
  • Type β€” the event category (e.g. other, contact.created, deal.propertyChange)
  • Click to view details β€” expands the raw event payload panel on the right, showing the full JSON data Lighthouse received from the source app

Steps β€” The Execution Log

The Steps section shows each action inside your workflow in sequence.
ElementWhat It Shows
Step numberSteps run in order from top to bottom β€” Step 1, Step 2, Step 3…
KeyThe internal name of the step β€” e.g. fetch-deal-details, find-or-create-xero-contact
StatusWhether this individual step finished, failed, or is still running
FinishedThe exact time this step completed
Click to view detailsExpands inline to show the step’s input data, output data, and any error message
When a run fails, scroll through the Steps list to find the first step with a red status β€” that is where the problem occurred. Expand it using Click to view details to read the error message and the data that was passed into that step. This almost always reveals the root cause.

Event Details Panel

The right-hand panel shows the raw JSON payload of the selected event or step β€” the exact data Lighthouse received from or sent to the connected system. Use this panel to:
  • Verify that the correct HubSpot deal properties were captured
  • Check that field values match what your destination app (e.g. Xero) requires
  • Copy the payload to share with the Cloudify support team

β‹― The Actions Menu

Click the three-dot menu on any row to access two actions: Retrigger and View.
Actions Menu

Retrigger vs Re-run β€” Which to Use

Use Retrigger when…Use Re-run when…
The source record in HubSpot has been updated since the original runYou want to replay the exact data that was captured at the time of the original run
You fixed a data issue and want the workflow to pick up the corrected valuesThe failure was a transient error (e.g. a timeout) with no data changes needed
You want to test whether a configuration change resolves the issue with current dataYou want to confirm the original payload now processes correctly after a Cloudify fix
Retriggering a run that already succeeded will create a second execution. For workflows that create records in Xero or other destination systems, this may produce duplicate entries. Always confirm the original run failed or produced incorrect output before retriggering.

Customising the Table View

Click View in the top-right corner of the Workflow Runs list to open the Toggle columns panel. Use it to show or hide columns based on what you need.
Toggle Columns
ColumnWhat It ShowsWhen to Enable It
IdThe unique run IDAlways β€” useful for referencing runs in support
WorkflowNameThe name of the integrationAlways β€” essential when running multiple workflows
WorkflowIdThe internal workflow definition IDOnly when debugging with Cloudify support
StatusThe run outcomeAlways β€” core to daily monitoring
StartedAtWhen the run beganAlways β€” sort by this to see the most recent runs first
CreatedAtWhen the run record was created in LighthouseOptional β€” differs from StartedAt only for queued runs
ModeLive or Test execution contextEnable when running tests alongside live workflows
Recommended default: Enable Id, WorkflowName, Status, and StartedAt. Add Mode during active testing to clearly separate sandbox runs from production runs in the list.

Filtering Runs

Use the filter bar at the top of the list to narrow down what you see.
FilterUse It To
Search boxSearch by reference (e.g. a HubSpot Deal ID) or by run ID β€” useful when a client reports an issue with a specific record
Pick a dateFilter by a specific date or date range β€” use this to investigate incidents from a particular day
StatusShow only runs with a specific status β€” Pending, Running, Finished, Failed, or Skipped. Set to Failed to surface all current issues at once
WorkflowFilter by integration name β€” useful when multiple workflows are active and you want to isolate one
ModeFilter by Live or Test β€” separates production runs from sandbox runs during setup and testing

Quick Reference β€” Common Scenarios

  1. Click πŸ’¬ Explain (speech-bubble icon) on the row for a plain-English summary.
  2. Click πŸ‘ View (eye icon) to open the detail page.
  3. In the Steps section, find the first step with a red status.
  4. Expand it using Click to view details to read the error message.
  5. Fix the root cause in the source system (e.g. HubSpot), then use β‹― β†’ Retrigger.
Use β‹― β†’ Retrigger from the Actions menu. This re-fetches the latest record from HubSpot and runs the workflow from scratch using the updated data. Do not use Re-run β€” it replays the original (now outdated) payload.
Open the detail page using πŸ‘ View and click the blue Re-run button. This replays the original event payload without re-fetching from HubSpot β€” correct when the data was fine but the execution failed transiently.
In the filter bar, set Status to Failed and click Pick a date to select the relevant date. The list will show only failed runs from that day.
Open the detail page using πŸ‘ View. In the Steps section, find the step that writes to Xero (e.g. create-xero-invoice). Expand it using Click to view details. The right-hand Event Details panel shows the exact output data that was sent.
Open the detail page and note the Run ID from the metadata header. In the Event Details panel, copy the relevant payload using the copy icon. Include both the Run ID and the payload in your support ticket β€” this lets Cloudify investigate immediately without additional back-and-forth.
Pending means the run is queued and waiting for Lighthouse to start processing it. This is typically temporary β€” refresh the page after a few moments. If a run stays Pending for an extended period, raise a support ticket.

Next Steps

Support

Raise a ticket with Cloudify if a failed run cannot be resolved by Retrigger or Re-run.

Connections

Check connection status if you suspect an authentication issue is causing persistent failures.