> ## Documentation Index
> Fetch the complete documentation index at: https://www.integrate.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ETL: Audit Log

> See who changed what in your Integrate.io ETL account: configuration changes, member updates, sign-ins and job runs, with filters and CSV export.

The audit log is an account-level record of who did what, and when. It lists configuration changes, member and role changes, sign-ins, key and token events, and job runs in your account, newest first. Use it to collect compliance evidence or to investigate an incident.

Integrate.io records events only after the audit log is turned on for your account. Nothing from before that moment is recorded or backfilled. Integrate.io keeps events for 90 days and deletes older events nightly.

> [!NOTE]
>
> The audit log is an opt-in account feature. If the page shows "To enable audit logs on your account, contact your account manager or support.", contact your account manager or Support to turn it on.

## Who can view the audit log

You can view and export the audit log when you have one of these roles:

* Owner or Admin on the account.
* A custom role that includes the **View and export the audit log** permission (`viewAuditLog`). See [Custom Roles](https://www.integrate.io/docs/etl/custom-roles.md#permission-reference).

Members without the permission see "You do not have permission to view the audit log. Contact your account administrator." The permission covers every package group and connection in the account, whatever else the member's role is limited to.

## Viewing the audit log

**Step 1**

On the left menu, open **Settings**.

**Step 2**

Under **Account**, click **Audit Log**.

Right after the feature is turned on, the page shows "No activity yet. Events are recorded from" followed by the date recording started.

The table has these columns:

| Column | Shows |
| :- | :- |
| **Time** | When the event happened, in the time zone of your profile. The column header names the time zone. |
| **User** | The email of who performed the action, with a label for how they did it: **DASHBOARD**, **API KEY**, **MCP**, or **SYSTEM**. |
| **Action** | What happened, for example a connection update or a failed sign-in. |
| **Resource** | The name and type of the affected resource. The name links to the resource when it still exists. |
| **IP Address** | The IP address the request came from. |

The table shows 50 events at a time. Click **Load more** to see older events.

### Event details

Click a row to expand it. The details have up to three parts:

* **Changes**: a table of **Field**, **From**, and **To** values for the fields that changed. When a record is deleted, its last values appear under **Deleted values**.
* **Details**: extra information for the event, such as the old and new role in a role change.
* **Request**: the event name, IP address, client (for example, "Chrome on macOS"), and request ID. Events from the same request share a request ID.

Integrate.io never records secret values:

* Fields that hold secrets show `[FILTERED]`.
* Changes to a connection's host, port, database, or password show `[CHANGED]` without the old or new value.
* For account and global variables and secrets, only the key names are recorded.

## Filtering events

Use the filter bar above the table, then click **Apply**. Click **Reset** to clear every filter.

| Filter | Options |
| :- | :- |
| **When** | **Any time** (default), **Last 24 hours**, **Last 7 days**, **Last 30 days**, or **Custom range...**, which shows **From** and **To** date pickers. |
| **Event** | **All events**, every event in one category (for example, **All connection events**), or a single event. The list is searchable and grouped by category. |
| **User** | **Anyone**, a kind of actor under **By kind** (**Dashboard**, **API key**, **MCP**, **System**), or a specific member. |

The preset time ranges are rolling windows measured from when you click **Apply**. Custom dates are read in your profile's time zone.

The filters are saved in the page URL. Reload the page or share the link to open the same filtered view.

## Exporting to CSV

Click **Export CSV** at the top right of the page. The file contains the events that match the current filters, up to 10,000 rows. If more than 10,000 events match, the export fails with an error. Narrow the date range and export again.

Integrate.io records each export in the audit log.

## What the audit log records

Events are grouped into these categories in the **Event** filter:

| Category | Recorded events |
| :- | :- |
| Connections | Connection created, updated, or deleted. |
| Packages | Package created, updated, deleted, restored, or cloned; version saved; rolled back to an earlier version. |
| Jobs | Job run and job stopped by a user. |
| Schedules | Schedule created, updated, or deleted; enabled or disabled; run; cloned. |
| Clusters | Cluster created, updated, or terminated. |
| Package groups | Package group created, updated, or deleted; connection access updated. |
| Connection groups | Connection group created, updated, or deleted. |
| Members | Member invited, joined, removed, or left; member role or custom roles changed. |
| Custom roles | Custom role created, updated, or deleted; custom role members changed. |
| Account | Account settings, account variables, and global variables and secrets updated; account owner changed. |
| Service hooks and log drains | Service hooks and log drains created, updated, or deleted. |
| Keys and tokens | API key regenerated; personal tokens created or revoked; AI API keys created or deleted; PGP keys added, updated, or removed; SSH keys added or removed. |
| Sign-ins and security | Sign-in (including SSO sign-ins), failed sign-in, sign-out; password updated; MFA enrolled or unenrolled. |
| Audit log | Audit log exported. |

### Who appears in the User column

* **DASHBOARD**: a member working in the Integrate.io dashboard.
* **API KEY**: a request made with an API key.
* **MCP**: an AI agent working through the [Integrate.io MCP server](https://www.integrate.io/docs/etl/integrateio-mcp-server.md).
* **SYSTEM**: an action Integrate.io performed with no user behind it.

When Integrate.io staff change something in your account, the event shows **Integrate.io Support** as the user. Staff sign-ins, sign-outs, and page views are not recorded in customer accounts, and neither are changes staff make to their own profile (password, MFA, or API key).

### Sign-ins and invited members

Sign-ins and other personal events (password and MFA changes) appear in every account the user belongs to and has joined. A member added by invitation joins the account when they first open it. Accepting the invitation, or first launching Integrate.io from it, also counts as joining, but only when it is their only pending invitation. Until then, that account does not receive their personal events.

### Not recorded yet

The audit log does not yet record:

* Member role changes and removals made through the legacy members interface.
* Clusters terminated from the legacy interface or by Integrate.io staff tools.
* Sign-ins through partner add-on SSO.

## Reading the audit log through the API

The audit log is also available through the Integrate.io API. Requests need an API key for a user who can view the audit log, and they return 404 when the feature is off for the account.

```bash theme={null}
curl -u API_KEY: \
  -H "Accept: application/vnd.xplenty+json; version=2" \
  "https://api.xplenty.com/ACCOUNT_ID/api/audit_events?since=2026-11-01&event=connection.*"
```

The endpoint accepts `since` and `until` (an ISO 8601 timestamp or a date), `event` (an exact event name, a `category.*` pattern, or a comma-separated list), `actor_type`, `actor_id`, `target_type`, and `target_id`. Results are newest first and paginated with a `Link` header. `GET /audit_events/export` returns the same results as CSV, with the same 10,000-row limit.

## FAQ

**Why is the audit log empty for dates before it was turned on?**

Integrate.io starts recording when the feature is turned on for the account. Earlier activity is not backfilled.

**Why don't I see a member's sign-ins?**

The member has not joined the account yet. Their sign-ins appear after they first open the account. Accepting the invitation, or first launching Integrate.io from it, also counts, but only when it is their only pending invitation.

**Why does a connection change show `[CHANGED]` instead of the new value?**

Connection host, port, database, and password values are never stored in the audit log. The row shows that the field changed without showing the values.

**How long are events kept?**

90 days. Integrate.io deletes older events nightly. Export the log to CSV regularly if you need a longer history.

**Can a custom role view the audit log?**

Yes. Edit the role and tick **View and export the audit log** under **Audit Log**. The Reader, Editor, and Operator presets do not include it.

## Related

> [card] [Custom Roles](https://www.integrate.io/docs/etl/custom-roles.md)

> [card] [Setting Account Member Roles](https://www.integrate.io/docs/etl/setting-account-member-roles.md)

> [card] [Managing Account Members](https://www.integrate.io/docs/etl/managing-your-integrateio-etl-account-members.md)

> [card] [Log Drains](https://www.integrate.io/docs/etl/log-drains.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.