HUhubspot
Basic

Retrieves users

Changed on

Retrieve a paginated list of users in your HubSpot account. This endpoint allows you to specify the maximum number of results per page and to use a paging cursor for navigating through the list of users.

get/settings/users/2026-09

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/settings/users/2026-09
  • Auth
    • OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: crm.objects.users.read
    • or OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: settings.users.read

Query parameters

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.

limitinteger

The maximum number of results to display per page.

Response

successful operation

Changes

  • 2026-099aa42e094343Revision changes
    • info

      the security scope crm.objects.users.read was added to the endpoint's security scheme oauth2

    • info

      the security scope settings.users.read was removed from the endpoint's security scheme oauth2

  • 2026-091ec62479c06aRevision changes
    • info

      the security scope crm.objects.users.read was added to the endpoint's security scheme oauth2

    • info

      the security scope settings.users.read was removed from the endpoint's security scheme oauth2