# Account Events

Retrieves account activity and audit events from OwnBackup API for security monitoring and compliance tracking.

**Sync Type: Incremental**

## Requirements

Before you connect Monad to OwnBackup, you need:

1. **OAuth Credentials**
   - Client ID for your OwnBackup account
   - Refresh token from your OwnBackup account
   - Instructions: [Generating Refresh Token](https://help.salesforce.com/s/articleView?id=platform.platform_o_manage_api_tokens.htm&type=5)

2. **Identify Your Region**
   - Determine which OwnBackup region your instance is hosted in
   - Valid regions: `app1` (US), `emea1` (Europe), `uk1` (UK), `usgov2` (US Government), `hippa1` (HIPAA)
   - Your region will be used in the API endpoint URL

## Details

Monad keeps track of the state of the input via event IDs. The input uses the `event_id` field to track which events have been processed and automatically resumes from the last event on subsequent runs. This ensures that only new events are retrieved between syncs, providing true incremental synchronization.

The OwnBackup API returns events in batches of up to 1000 records. Monad automatically handles pagination by using the `from` parameter to fetch subsequent pages until all events are retrieved.

## Configuration

#### Settings

| Setting | Type | Required | Description |
|---------|------|----------|-------------|
| region | string | Yes | The OwnBackup region where your instance is hosted (app1, emea1, uk1, usgov2, hippa1) |
| 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

| Secret | Type | Required | Description |
|--------|------|----------|-------------|
| client_id | string | Yes | OAuth client ID for your OwnBackup account |
| refresh_token | string | Yes | OAuth refresh token for your OwnBackup account |

**Header**: `Authorization` (Bearer Token)
**Source**: OwnBackup API documentation

## Related Articles

- [Own API - Account Events](https://developer.salesforce.com/docs/platform/own-api/references/own-api-rest#operation/getAccountEventsHistory)
- [Steps for generating refresh token](https://help.salesforce.com/s/articleView?id=platform.platform_o_manage_api_tokens.htm&type=5)
- [Auth API](https://developer.salesforce.com/docs/platform/own-api/references/own-api-rest#operation/userLogin)

## Sample Record

```json
{
  "created_at": "2019-08-24T14:15:22Z",
  "event_id": 42857,
  "ip_address": "203.0.113.45",
  "key": "akl8dj3k2l9dk2l9dk2l9",
  "parameters": {},
  "service_id": null,
  "source": "web app",
  "user_email": "john.doe@example.com",
  "user_id": 12345
}
```

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