# User Audit Logs

**Sync Type: Incremental**

## Overview

The Persona User Audit Logs input collects comprehensive audit trail data from your Persona organization, providing visibility into API usage, user actions, and system events. This integration captures detailed logs including API endpoints accessed, HTTP methods used, request parameters, IP addresses, response status codes, and timestamps.


## Prerequisites

### 1. Persona Production Account

You must have access to a **Persona Production Account** to use this integration. User audit logs are not available in Sandbox environments for security reasons, as they contain organization-level sensitive data.

**Important Security Note:** User audit logs contain sensitive organizational data and are only accessible via production API keys. Ensure proper access controls are in place when configuring this integration.

## API Key Setup

1. **Navigate to API Keys**
   - Log into your [Persona Dashboard](https://app.withpersona.com)
   - In the left navigation panel, hover on **API** and select **API Keys** from the visible options.

2. **Create New Key**
   - Click the **Create API key** button in the top-right.

3. **Configure Key Settings**
   - **Name:** Provide a descriptive name (e.g., "Audit Logs Integration").

5. **Save and Store Key**
   - Copy the generated API key value from the list of API Keys.

## Configuration

### Settings

| Setting | Type | Required | Description |
|---------|------|----------|-------------|
| API Rate Limit | object | No | Optional limit on the connector's outbound request rate to the source API. Leave blank to use the connector's default behavior. See [API Rate Limiting](../../../guides/rate-limiting) for the field format, limits, and how to choose a value. |

### Secrets

| Setting | Type | Required | Description |
|---------|------|----------|-------------|
| API Key | string | true | API key created from Persona Production Account |

### Data Retention

- Persona retains user audit logs for up to **6 months**
- Logs are returned in reverse chronological order (most recent first)

## Related Articles

- [Persona User Audit Logs - API Reference](https://docs.withpersona.com/api-reference/user-audit-logs/list-all-user-audit-logs)
- [Persona Portal](https://app.withpersona.com)

## Sync frequency

By default this input polls approximately every 10 seconds, with each sync beginning after the previous one completes. A cron schedule configured on the pipeline overrides this cadence. See [Input Sync Frequency](../../guides/sync-frequency) for details.