HUhubspot
Basic

Retrieve audit logs

Changed on

Retrieve activity history for user actions related to approvals, content updates, CRM object updates, security activity, and more (Enterprise only). Learn more about activities included in audit log exports.

get/account-info/2026-09/activity/audit-logs

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/account-info/2026-09/activity/audit-logs
  • Auth
    OAuth 2
    Authorization code: https://app.hubspot.com/oauth/authorize
    Token URL: https://api.hubapi.com/oauth/v1/token scopes: account-info.security.read

Query parameters

actingUserIdinteger[]

An array of user IDs to filter the audit logs by the acting users.

afterstring

The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results.

fillFinalTimestampboolean

A boolean indicating whether to fill the final timestamp in the response.

limitinteger

The maximum number of results to display per page.

occurredAfterstring date-time

The start date and time for filtering logs, in ISO 8601 format.

occurredBeforestring date-time

The end date and time for filtering logs, in ISO 8601 format.

sortstring[]

An array of fields to sort the results by.

Response

successful operation

Changes

  • 2026-09fc8daf99a7abRevision changes
    • info

      api operation id get-/account-info/2026-09/activity/audit-logs_/account-info/2026-03/activity/audit-logs removed and replaced with get-/account-info/2026-09/activity/audit-logs

    • info

      the endpoint scheme security private_apps was removed from the API