> ## 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.

# Events

> Learn how events work in HireData: how connected apps send them, where to find the event log, and how to inspect payloads to debug your automations.

*When you connect your ATS, such as Carerix, Salesforce, OTYS, etc., to HireData, it will start sending events, which are notifications that something has happened in your system. Events trigger your automations, making them crucial to how HireData works in the background. In this article, we'll explain how events work, where to find them, and how to analyse them if something doesn't go as expected.*

## What is an event

An event is a signal sent from your connected app to HireData. It usually represents a specific action or change, for example, a new candidate being created, a vacancy being updated, a placement being completed, etc. These events are used to trigger the automations you've set up in HireData, and every event includes **Event Data**, **External Records **and** Processes.**

*Event example:*

<img src="https://mintcdn.com/hiredata/apTqTT3qqSvZDvKt/images/intercom/48025433-Screenshot-2025-05-05-at-10_51_18.png?fit=max&auto=format&n=apTqTT3qqSvZDvKt&q=85&s=1b1c1769fdd30b85df110295f2400b77" alt="Individual event page" width="2542" height="928" data-path="images/intercom/48025433-Screenshot-2025-05-05-at-10_51_18.png" />

## How to view event details

Navigate to the **Settings** menu and open the **Events** page to see a list of all events sent from your connected apps:

<img src="https://mintcdn.com/hiredata/apTqTT3qqSvZDvKt/images/intercom/48023611-Screenshot-2025-05-05-at-12_06_25.png?fit=max&auto=format&n=apTqTT3qqSvZDvKt&q=85&s=a20d6de3a3df5dfb2064ab2d364b636d" alt="Events page in HireData" width="2554" height="1446" data-path="images/intercom/48023611-Screenshot-2025-05-05-at-12_06_25.png" />

*Use the filters for a more organised view, for example, if you want to see the events coming from one of your apps:*

<img src="https://mintcdn.com/hiredata/apTqTT3qqSvZDvKt/images/intercom/48024595-Screenshot-2025-05-05-at-10_49_56.png?fit=max&auto=format&n=apTqTT3qqSvZDvKt&q=85&s=c07217d31920b198a051998f7920639b" alt="Setting up filters" width="2114" height="712" data-path="images/intercom/48024595-Screenshot-2025-05-05-at-10_49_56.png" />

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

<img src="https://mintcdn.com/hiredata/apTqTT3qqSvZDvKt/images/intercom/48023846-Screenshot-2025-05-05-at-10_50_57.png?fit=max&auto=format&n=apTqTT3qqSvZDvKt&q=85&s=d2d86f955261554c58d52424915ea794" alt="Event drop-down menu" width="2114" height="220" data-path="images/intercom/48023846-Screenshot-2025-05-05-at-10_50_57.png" />

This will open the event detail view, which includes:

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

<img src="https://mintcdn.com/hiredata/apTqTT3qqSvZDvKt/images/intercom/48023945-Screenshot-2025-05-05-at-10_51_18.png?fit=max&auto=format&n=apTqTT3qqSvZDvKt&q=85&s=e85d78ccf9fedab558eab690a1cc1335" alt="Event Data tab" width="2542" height="928" data-path="images/intercom/48023945-Screenshot-2025-05-05-at-10_51_18.png" />

* **External Records** – additional fields from the source app, even if they aren't used in the automation.

<img src="https://mintcdn.com/hiredata/apTqTT3qqSvZDvKt/images/intercom/48024008-Screenshot-2025-05-05-at-10_51_53.png?fit=max&auto=format&n=apTqTT3qqSvZDvKt&q=85&s=ba7c63c27e996fe24030d0eef506e784" alt="External records tab" width="2542" height="1456" data-path="images/intercom/48024008-Screenshot-2025-05-05-at-10_51_53.png" />

* **Processes** – the list of automation(s) triggered by this event and the runs it created. You'll also see each run's status (e.g. Completed, Delayed, Cancelled).

<img src="https://mintcdn.com/hiredata/apTqTT3qqSvZDvKt/images/intercom/48024037-Screenshot-2025-05-05-at-10_52_01.png?fit=max&auto=format&n=apTqTT3qqSvZDvKt&q=85&s=9c05fe3cb8548fec4cdb253fd79c0691" alt="Processes tab" width="2542" height="1456" data-path="images/intercom/48024037-Screenshot-2025-05-05-at-10_52_01.png" />

## Replaying events

If an event doesn't trigger an automation as expected, or a run fails before completing its tasks, you can replay individual or multiple events to re-trigger automations and get things back on track.

<Warning>
  When you replay an event, it can trigger runs across multiple automations at once. Before replaying, always check which automations and runs will be affected, especially if any of them include sending an email or a message. Replaying those without checking first could result in duplicate messages being sent to candidates or contacts.
</Warning>

### What happens when an event is replayed?

HireData reprocesses the selected event(s) and triggers the associated automations. The affected tasks will be executed as if the event had just occurred.

* **Event-based automations** – For automations that are triggered by a specific event (for example, a candidate reaching a certain stage), the replay will re-trigger the automation immediately based on the event data. If there was previously a created run, it will be replayed and a "Replay" label will show up.

<img src="https://mintcdn.com/hiredata/owvMgk31p9T9eteW/images/intercom/146643359-Screenshot-2026-05-28-at-13_08_04.png?fit=max&auto=format&n=owvMgk31p9T9eteW&q=85&s=3fa50d436fab1ae32b576bca70900a80" alt="An event labeled as Replayed" width="622" height="134" data-path="images/intercom/146643359-Screenshot-2026-05-28-at-13_08_04.png" />

* **Scheduled (one-time) automations** – For automations that run on a fixed date or schedule, replaying the event will not change or reschedule the automation's planned run date. The replay only re-evaluates whether the event matches the automation's conditions.

### How to replay events

<Steps>
  <Step title="Find the event you want to replay">
    There are three ways to get to the replay option, depending on what you need:

    * **From the Events page (all events)** – Navigate to the **Events** page from the main menu. This gives you an overview of all events received by HireData.

          <img src="https://mintcdn.com/hiredata/owvMgk31p9T9eteW/images/intercom/146643741-Screenshot-2026-05-28-at-13_06_02.png?fit=max&auto=format&n=owvMgk31p9T9eteW&q=85&s=557c5577de004bc987195325faba94c2" alt="The Events page" width="3018" height="1376" data-path="images/intercom/146643741-Screenshot-2026-05-28-at-13_06_02.png" />

    * **From a specific automation** – Open the automation you want to investigate, then go to its **Events** page. This filters the view to only show events related to that automation.

          <img src="https://mintcdn.com/hiredata/owvMgk31p9T9eteW/images/intercom/146650572-Screenshot-2026-05-28-at-13_19_57.png?fit=max&auto=format&n=owvMgk31p9T9eteW&q=85&s=67eaeac69d2ae800c28799d4128e03c2" alt="Finding the Events page for a specific automation" width="404" height="538" data-path="images/intercom/146650572-Screenshot-2026-05-28-at-13_19_57.png" />

          <img src="https://mintcdn.com/hiredata/owvMgk31p9T9eteW/images/intercom/146644665-Screenshot-2026-05-28-at-13_20_17.png?fit=max&auto=format&n=owvMgk31p9T9eteW&q=85&s=591af9f3a55d689328eddb3a4bdb7d51" alt="The Events page for a specific automation" width="2522" height="1256" data-path="images/intercom/146644665-Screenshot-2026-05-28-at-13_20_17.png" />

    * **From a single event** – Click directly on the event you want to replay to open its detail view.
  </Step>

  <Step title="Select the event(s) to replay">
    To replay a **single event**, click the three-dot menu next to the event in the detail view or the **Events** list, and select **Replay** from the dropdown.

    <img src="https://mintcdn.com/hiredata/owvMgk31p9T9eteW/images/intercom/146645337-Screenshot-2026-05-28-at-13_06_43.png?fit=max&auto=format&n=owvMgk31p9T9eteW&q=85&s=89877acd99416e0af9206740d8b128af" alt="Replaying an individual event" width="2530" height="196" data-path="images/intercom/146645337-Screenshot-2026-05-28-at-13_06_43.png" />

    To replay **multiple events at once**, check the box next to each event you want to replay on the **Events** page or an automation's **Events** tab. Once one or more events are selected, a **Replay** button will appear at the top of the page. Click it to proceed.

    <img src="https://mintcdn.com/hiredata/owvMgk31p9T9eteW/images/intercom/146646000-Screenshot-2026-05-28-at-13_06_24.png?fit=max&auto=format&n=owvMgk31p9T9eteW&q=85&s=6c7c4d94e7e8681d93c552b3ed82aada" alt="Replaying events in bulk" width="2528" height="462" data-path="images/intercom/146646000-Screenshot-2026-05-28-at-13_06_24.png" />
  </Step>

  <Step title="Review and confirm the replay">
    To see which automations were previously triggered by the event, open the event and go to the **Runs** tab. This shows you the automations and their status from the last time the event was processed. Use this information to decide whether it's safe to proceed with the replay.

    <img src="https://mintcdn.com/hiredata/owvMgk31p9T9eteW/images/intercom/146646806-Screenshot-2026-05-28-at-13_20_50.png?fit=max&auto=format&n=owvMgk31p9T9eteW&q=85&s=d90c24dee54ef94e57d4bfd0f0fe594b" alt="Reviewing which automations and runs will be triggered by the replay" width="2516" height="368" data-path="images/intercom/146646806-Screenshot-2026-05-28-at-13_20_50.png" />

    Check whether any of the listed automations include tasks like **Send Email/Message/Survey**. If they do, make sure you intend for those messages to be sent again before confirming.

    Once you're confident, confirm the replay.
  </Step>
</Steps>

<Tip>
  * **Always review the affected automations before confirming a replay.** One event can match multiple automations, and replaying it will trigger all of them.
  * **Be extra cautious with automations that send emails or messages.** Replaying an event tied to those automations may send duplicate communications to candidates or contacts.
  * **Use the automation-specific Events tab if you only want to replay within a single automation.** This gives you a more focused view and reduces the risk of unintentionally triggering unrelated automations.
  * **Bulk replay is useful when multiple events failed at the same time**, for example, after a temporary sync issue. Instead of replaying one by one, you can select all affected events and replay them together.
</Tip>

## Troubleshooting events

If an automation didn't run as expected, or you're seeing unexpected data:

* Go to the **Processes** tab of the event and check if any runs were created.
* Click into the run to view logs and see if a step failed or was skipped.
* Compare the **Event Data** with the conditions in your automation to ensure it matches.

If no process was triggered, the event likely didn't meet the criteria of any active automations.

### Still need help?

If you're unsure why an event didn't trigger your automation or want help interpreting the event data, 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 event;
* A link or the name of the automation you expected to be triggered;
* Any relevant steps or context that might help us investigate throughout.


## Related topics

- [Task History](/pages/task-history.md)
- [How to Test an Automation](/automations/how-to-test-an-automation.md)
- [Why Didn't My Automation Run?](/knowledge-base/why-didnt-my-automation-run.md)
- [Set up a trigger](/apps/custom-apps/set-up-a-trigger.md)
- [Runs](/settings/logs/runs.md)
