Skip to main content
GET
List Audit Logs
Returns a paginated, filterable log of every write action performed in the workspace — API calls, user actions, and automations. Essential for SOC 2, ISO 27001, and internal forensics.
This endpoint requires an admin API key. Standard API keys receive a 403 insufficient_permissions response.

Request

Query Parameters

integer
default:"1"
Page number for pagination
integer
default:"50"
Entries per page (max: 200)
string
Filter by action: create, update, delete, login, api_access
string
Filter by the UUID of the acting user (human user only — API keys are filtered separately)
string
Filter by resource type: contacts, companies, deals, tasks, notes, lists, campaigns, webhooks, api_keys, users
string
Only entries on or after this ISO 8601 date/timestamp
string
Only entries on or before this ISO 8601 date/timestamp

Headers

Audit logs are retained for 365 days and are immutable once written.

Response

object
object

Example Response

Errors