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

# Audit Logs

> View a full history of account-level changes, user actions, and system events — and restore deleted pipelines — in the HoopAI Platform.

Audit Logs are a vital component of your account that provides a detailed record of all activities and changes made within various modules such as contacts, calendars, opportunities, and communications. These logs are instrumental in tracking the source of changes, ensuring data integrity, and facilitating troubleshooting.

Navigate to **Settings > Audit Logs** to get started.

<Frame caption="Audit Logs overview">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/fpcCfUClUku7SftL/images/settings-audit-logs.png?fit=max&auto=format&n=fpcCfUClUku7SftL&q=85&s=07e76df8a40b40b0412585eb8c4b7307" alt="Audit Logs" width="1570" height="557" data-path="images/settings-audit-logs.png" />
</Frame>

<Note>
  Audit log access is typically restricted to account administrators. Contact your administrator if this section is not visible.
</Note>

## What is logged

The audit log captures a wide range of events including:

* **User access** — logins, logouts, and password changes
* **Contact changes** — field edits, tag additions and removals, contact deletions
* **Opportunity updates** — stage changes, value edits, owner reassignments
* **Calendar changes** — appointment creation, edits, cancellations
* **Settings changes** — updates to business profile, phone numbers, integrations, and user permissions
* **Automation activity** — workflow creation, edits, enable/disable toggles
* **Payment events** — invoice creation, payment status changes
* **Staff management** — user additions, role changes, deactivations

***

## Reading the log

Each log entry shows:

| Column          | Description                                                     |
| --------------- | --------------------------------------------------------------- |
| **Timestamp**   | Date and time the action occurred                               |
| **User**        | The team member who performed the action                        |
| **Event type**  | The category of action (contact edit, login, etc.)              |
| **Description** | A summary of what changed                                       |
| **Record**      | The specific contact, opportunity, or setting that was affected |

<Frame caption="Audit log entry — timestamp, user, event type, description, and affected record for each action">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/fpcCfUClUku7SftL/images/reporting-audit-generate.png?fit=max&auto=format&n=fpcCfUClUku7SftL&q=85&s=e42ad92119ecf8818cc8e41252b5674a" alt="Audit log detail" width="1488" height="563" data-path="images/reporting-audit-generate.png" />
</Frame>

***

## Filtering the log

Use the filter controls to narrow the audit log view:

* **Date range** — view events from a specific period
* **User** — see only actions from a specific team member
* **Event type** — focus on a particular category (e.g., only contact changes, only settings changes)
* **Module** — filter by specific modules (contacts, opportunities, calendars, etc.)

***

## Exporting audit logs

Click **Export** to download the filtered log as a CSV file. This is useful for compliance reporting, incident investigations, or sharing with external auditors.

<Frame caption="Audit log export and pipeline restore — filter by user, event type, and module, then export as CSV">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/fpcCfUClUku7SftL/images/reporting-audit-results.png?fit=max&auto=format&n=fpcCfUClUku7SftL&q=85&s=4c64eb1447fbfc71d22090c71e735651" alt="Audit log filter export" width="630" height="706" data-path="images/reporting-audit-results.png" />
</Frame>

***

## Restoring a deleted pipeline

If a pipeline is accidentally deleted, you can restore it from the Audit Logs:

<Steps>
  <Step title="Open Audit Logs">
    Navigate to **Settings > Audit Logs**.
  </Step>

  <Step title="Filter for pipeline deletion">
    Filter the log by **Event Type: Deleted** and look for the pipeline deletion event.
  </Step>

  <Step title="Select the event">
    Click on the pipeline deletion log entry to expand its details.
  </Step>

  <Step title="Restore the pipeline">
    Click the **Restore** action associated with the deletion event to recover the pipeline and its associated opportunities.
  </Step>
</Steps>

<Note>
  Pipeline restoration is available for a limited time after deletion. Contact Hoop support if the restore option is no longer available for an older deletion.
</Note>

***

## Audit logs for custom objects

Custom objects also have their own audit trail. Navigate to **Settings > Objects** and open a custom object to view its specific audit log for changes made to records within that object.

***

## Related articles

* [My staff](/settings/my-staff)
* [Audit reports](/reporting/audit-reports)
* [Objects](/settings/objects)
* [Private integrations](/settings/private-integrations)