> ## Documentation Index
> Fetch the complete documentation index at: https://help.hiredata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Runs

> Learn what runs are in HireData, how they capture each step of a triggered automation, and how to read run logs to troubleshoot recruitment workflows fast.

*When an automation is triggered by an event from your connected app, e.g. Carerix, Salesforce, etc., a Run is created. This Run represents the full process that follows from the initial trigger to each step of your automation. In this article, we will walk through what runs are, how to find and read them, and how they can help you troubleshoot your automations.*

## What is a run

A run is the result of an automation being triggered. It shows the exact sequence of actions that took place after an event was received, for example, a filter being checked, a delay being completed, or an email being sent/conversation ended. Each Run includes a full timeline of the steps taken, an **Overview**, **Fields**, and \*\*Related \*\*tabs.

Once a run is successfully completed, it will be reflected in the **Task History** page by adding a new task to the list.

## How to filter runs

Navigate to the **Settings** menu and open the **Runs** page to see a list of all runs:

<img src="https://mintcdn.com/hiredata/apTqTT3qqSvZDvKt/images/intercom/49924492-Screenshot-2025-05-05-at-10_54_30.png?fit=max&auto=format&n=apTqTT3qqSvZDvKt&q=85&s=7665d7a6bb8413fcabfa6b2f19f96f18" alt="Runs page in HireData" width="2544" height="1460" data-path="images/intercom/49924492-Screenshot-2025-05-05-at-10_54_30.png" />

Use the filters for a more organised view, for example, if you want to see the runs associated with one of your connected apps, or by narrowing them down by the state/stage they are currently in.

*Filtering runs by an app:*

<img src="https://mintcdn.com/hiredata/apTqTT3qqSvZDvKt/images/intercom/49925819-Screenshot-2025-05-16-at-10_37_44.png?fit=max&auto=format&n=apTqTT3qqSvZDvKt&q=85&s=4bf65db4d325dd622434f89973a883a3" alt="Filtering runs by an app" width="2106" height="748" data-path="images/intercom/49925819-Screenshot-2025-05-16-at-10_37_44.png" />

*Filtering runs by their state:*

<img src="https://mintcdn.com/hiredata/apTqTT3qqSvZDvKt/images/intercom/49925840-Screenshot-2025-05-16-at-10_37_59.png?fit=max&auto=format&n=apTqTT3qqSvZDvKt&q=85&s=e97d7aa03b478a5f2c5e04df7d890063" alt="Filtering runs by their state" width="2106" height="788" data-path="images/intercom/49925840-Screenshot-2025-05-16-at-10_37_59.png" />

*Filtering runs by their sub-state:*

<img src="https://mintcdn.com/hiredata/apTqTT3qqSvZDvKt/images/intercom/49925857-Screenshot-2025-05-16-at-10_38_22.png?fit=max&auto=format&n=apTqTT3qqSvZDvKt&q=85&s=73d79b2da660c27734a94e2d7ad41643" alt="Filtering runs by their sub-state" width="2106" height="654" data-path="images/intercom/49925857-Screenshot-2025-05-16-at-10_38_22.png" />

## How to view run details

To explore an individual run, click the \[Details] button next to the run for a short overview or open the dropdown menu and click \[View Run].

<img src="https://mintcdn.com/hiredata/apTqTT3qqSvZDvKt/images/intercom/49924583-Screenshot-2025-05-05-at-10_54_51.png?fit=max&auto=format&n=apTqTT3qqSvZDvKt&q=85&s=b40b04a26ae3d62c1d7038e485932b79" alt="How to view individual runs" width="2118" height="700" data-path="images/intercom/49924583-Screenshot-2025-05-05-at-10_54_51.png" />

This will open the run's detail view, which includes:

* **Overview** – a summarised view of the data received from your app.

<img src="https://mintcdn.com/hiredata/apTqTT3qqSvZDvKt/images/intercom/49924603-Screenshot-2025-05-05-at-10_55_16.png?fit=max&auto=format&n=apTqTT3qqSvZDvKt&q=85&s=408717ff111ae2fa2b7124a4711ec681" alt="Run Overview tab" width="2554" height="1446" data-path="images/intercom/49924603-Screenshot-2025-05-05-at-10_55_16.png" />

* **Fields** – fields with the data in the event that triggered the automation and might have been used in the run.

<img src="https://mintcdn.com/hiredata/apTqTT3qqSvZDvKt/images/intercom/49924650-Screenshot-2025-05-05-at-10_55_27.png?fit=max&auto=format&n=apTqTT3qqSvZDvKt&q=85&s=4757eb5ffa676d00d43f8017cfe60799" alt="Run Fields tab" width="2554" height="1446" data-path="images/intercom/49924650-Screenshot-2025-05-05-at-10_55_27.png" />

* **Related** – the automation this run followed and the event that triggered it.

<img src="https://mintcdn.com/hiredata/apTqTT3qqSvZDvKt/images/intercom/49924666-Screenshot-2025-05-05-at-10_55_33.png?fit=max&auto=format&n=apTqTT3qqSvZDvKt&q=85&s=9ba072291d4a1f86e1eeeca62a6a4ce0" alt="Run Related tab" width="2554" height="1446" data-path="images/intercom/49924666-Screenshot-2025-05-05-at-10_55_33.png" />

This detailed view also allows you to see exactly how your automation played out and whether each step succeeded.

## Troubleshooting runs

If something didn’t happen as expected:

* Open the detailed view of the run to view logs and see if a step failed or was skipped.
* Open the **Fields** tab to confirm whether the data used in the run met your conditions. You can also compare the run with the original event (found via the **Related** tab) to understand what triggered it and confirm if it used the correct data.

## Still need help?

If you're unsure why a run was cancelled/completed or want help interpreting the run's steps, feel free to contact our team at [support@hiredata.com](mailto:support@hiredata.com). If you do, please include:

* A link or the ID of the run;
* Any relevant data or context that might help us investigate further.


## Related topics

- [Why Didn't My Automation Run?](/knowledge-base/why-didnt-my-automation-run.md)
- [How to Test an Automation](/automations/how-to-test-an-automation.md)
- [Events](/settings/logs/events.md)
- [Set up a trigger](/apps/custom-apps/set-up-a-trigger.md)
- [How HireData Works](/concepts/how-hiredata-works.md)
