GET
/
cms
/
v3
/
audit-logs
/
Query audit logs
curl --request GET \
  --url https://api.hubapi.com/cms/v3/audit-logs/ \
  --header 'Authorization: Bearer <token>'
{
  "paging": {
    "next": {
      "link": "",
      "after": ""
    },
    "prev": {
      "before": "",
      "link": ""
    }
  },
  "results": [
    {
      "objectId": "4065364319",
      "objectName": "My Landing Page",
      "fullName": "John Doe",
      "event": "UPDATED",
      "userId": "1011561",
      "timestamp": "1583792674672",
      "objectType": "LANDING_PAGE"
    }
  ]
}
Supported products
Requires one of the following products or higher.
Marketing HubMarketing HubFree
Sales HubSales HubFree
Service HubService HubFree
Content HubContent HubEnterprise

​
Required Scopes

This API requires one of the following scopes:
  • content

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

​
userId
string[]

Comma separated list of user ids to filter by.

​
eventType
string[]

Comma separated list of event types to filter by (CREATED, UPDATED, PUBLISHED, DELETED, UNPUBLISHED).

​
objectType
string[]

Comma separated list of object types to filter by (BLOG, LANDING_PAGE, DOMAIN, HUBDB_TABLE etc.)

​
objectId
string[]

Comma separated list of object ids to filter by.

​
after
string

Timestamp after which audit logs will be returned

​
before
string

Timestamp before which audit logs will be returned

​
limit
integer

The number of logs to return.

​
sort
string[]

The sort direction for the audit logs. (Can only sort by timestamp).

Response

200
application/json

successful operation

The collection of audit logs.