# Audit Log Events

Fetches audit log events from Greenhouse Harvest API for tracking changes and administrative actions.

**Sync Type: Incremental**

## Requirements

Before you connect Monad to Greenhouse, you need a Harvest API Key and User ID:

1. [Create a Harvest API key](https://support.greenhouse.io/hc/en-us/articles/5888163769883-Create-a-Harvest-API-key-for-an-integration)
   1. Select the API type: `Harvest`
   2. Select Partner: `Custom`
   3. Enter a description and click Save. **Copy the API Key**.
   4. Once you have saved the API Key, set the API Key permissions.
      1. Under **Manage permissions**, select `Auditlog v1` and save.
2. Find the User ID of the user to pull data on behalf of
   1. The User should have "Site Admin" level permissions.
   2. Click on the user's name to load their profile. The User ID is available in the URL.
      Example: The User ID for `https://app4.greenhouse.io/account/users/4234884004/edit` would be `4234884004`.

## Details

Monad uses the [Audit Log Events API](https://developers.greenhouse.io/audit-log.html#events) to fetch incremental changes. The connector tracks the timestamp of the last fetched event and only retrieves new events on subsequent syncs. On the first sync, a full backfill of available audit log data is performed unless otherwise specified by the backfill start time.

## Limitations

1. This connector is restricted by [rate limits](https://developers.greenhouse.io/audit-log.html#rate-limiting)

## Configuration

The following configuration defines the input parameters. Each field's specifications, such as type, requirements, and descriptions, are detailed below.

#### Settings

| Setting | Type | Required | Description |
|---------|------|----------|-------------|
| User ID | string | Yes | User ID to pull data on behalf of. Must have "Site Admin" permissions. |
| Backfill Start Time | string | No | The date to start fetching data from. If not specified, no past records will be fetched. |
| 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 |
|---------|------|----------|-------------|
| Harvest API Key | string | Yes | API key for the Greenhouse account with `Auditlog v1` permissions. |

## Related Articles

- [Greenhouse Harvest API Documentation](https://developers.greenhouse.io/harvest.html)
- [Audit Log API Reference](https://developers.greenhouse.io/audit-log.html#events)
- [Creating Harvest API Keys](https://support.greenhouse.io/hc/en-us/articles/5888163769883-Create-a-Harvest-API-key-for-an-integration)

## Sample Record

```json
{
    "request": {
        "id": "1234zID",
        "type": "email_settings#create_organization_email"
    },
    "performer": {
        "meta": {
            "name": "Allison Jamie",
            "username": "allison.j@omniva-corp.com"
        },
        "id": 12345,
        "ip_address": "192.168.0.1",
        "type": "user"
    },
    "organization_id": 123,
    "event": {
        "meta": null,
        "target_type": "Global Email Added",
        "type": "action"
    },
    "event_time": "2023-06-02T16:06:19.217Z"
}
```