Skip to main content
GET
/
settings
/
v3
/
users
/
roles
Retrieves the roles on an account
curl --request GET \
  --url https://api.hubapi.com/settings/v3/users/roles \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "id": "100",
      "name": "Test Role",
      "requiresBillingWrite": "False"
    }
  ]
}

Supported products

Requires one of the following products or higher.
Marketing HubMarketing Hub -Free
Sales HubSales Hub -Free
Service HubService Hub -Free
Content HubContent Hub -Free
Data HubData Hub -Free

Authorizations

Authorization
string
header
required

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

Response

successful operation

results
object[]
required
Last modified on December 16, 2025