HUhubspot
Roles

Retrieves the roles on an account

Changed on

Retrieve a list of user roles available in your HubSpot account. This endpoint provides information about the different permission sets that can be assigned to users, which is useful for managing user access and permissions within the account.

get/settings/users/2026-09/roles

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/settings/users/2026-09/roles
  • 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

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