Skip to main content

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

Configuration​

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

Settings​

SettingTypeRequiredDescription
User IDstringYesUser ID to pull data on behalf of. Must have "Site Admin" permissions.
Backfill Start TimestringNoThe date to start fetching data from. If not specified, no past records will be fetched.

Secrets​

SecretTypeRequiredDescription
Harvest API KeystringYesAPI key for the Greenhouse account with Auditlog v1 permissions.

Sample Record​

{
    "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"
}