Audit Events
Fetches audit events from the Coda Admin API, providing comprehensive monitoring and compliance data for your Coda organization.
Sync Type: Incremental
Requirements
- A Coda account with at least one Enterprise workspace (auditing is only available for Enterprise workspaces)
- Organization admin privileges to generate API tokens
- Access to your Coda Organization ID from the organization settings
Finding Your Organization ID
- Navigate to your Coda dashboard
- Click on More options (found at the bottom left of the dashboard)
- Select Organization Settings
- The Organization ID can be found in the URL of the Organization Settings page
- Look for the path segment beginning with
org-(e.g.,org-aBcDeFgHiJ)
Generating an API Token
- Go to Account Settings > API Settings
- Create a new API token with Read only permissions
- Copy the generated token (format:
12345678-abcd-9012-abfe-345789012345) - Save this token securely as it will be needed for the connector configuration
Note: API tokens must be created by an organization admin.
Details
Monad uses the timestamp field from audit events to implement incremental synchronization. The connector tracks the timestamp of the last successfully processed event and only fetches newer events on subsequent runs. If this is the first time running the connector, a full sync of available audit events is performed.
The connector processes events in ascending chronological order to ensure proper incremental updates and uses pagination to handle large volumes of audit data efficiently.
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 |
|---|---|---|---|
| Organization ID | string | Yes | Your Coda Organization ID found in the organization settings URL (e.g., org-aBcDeFgHiJ) |
| Backfill Start Time | string | No | The date to start fetching data from. If not specified, no past records will be fetched. |
Secrets
| Secret | Type | Required | Description |
|---|---|---|---|
| API Token | string | Yes | API Token for the Coda Admin API. This must be generated by an organization admin with read-only permissions. |
Connector Limitations
- Enterprise Requirement: The Coda account must contain at least one Enterprise workspace for auditing to be enabled
- Rate Limits: This connector is subject to Coda's API rate limits, which may affect the speed of data collection for organizations with high audit event volumes
- Admin Access: API tokens can only be created by organization administrators
- Data Retention: Audit event availability depends on your Coda plan's data retention policies