Roles Endpoint Error

[JLim063]

I am trying to use this endpoint 

https://api.hubapi.com/settings/v3/users/roles

`https://developers.hubspot.com/docs/reference/api/settings/users/user-provisioning#get-%2Fsettings%2...

I have the scopes required from the API endpoint, but calling that endpoint gives me an error response below. 

```

{
"status": "error",
"message": "Account doesn't have access to roles.",
"correlationId": "4d845a93-43a3-44db-ae5d-321b72328e78",
"category": "VALIDATION_ERROR"
}

```

I have searched through previous forums, but couldn't find answers for it. 

How do you get role information? 

[Jaycee_Lewis · Accepted solution]

Hey, @JLim063  👋 Does your portal have an Enterprise subsection for at least one Hub? This is because in-app roles are referred to as Permission Sets. I agree this is confusing. 

A quick way to test this is to do two things:

• Go to your portal > Settings > Users and Teams > Permission Sets and verify if you have access. If so, note the names of the non-Super Admin Permission Sets (Roles)
• Use this endpoint to confirm (for yourself) that Permission Sets and Roles are the same, just named differently. If you have access, and have created at least one Permission Set, it will appear in the Role endpoint response

Here's my test:

In-app

 

Endpoint request and response

GET https://api.hubapi.com/settings/v3/users/rolesHTTP 200 {  "results": [    {      "id": "482176",      "name": "Ringmaster",      "requiresBillingWrite": false    },    {      "id": "1185020",      "name": "Red Team",      "requiresBillingWrite": false    }  ] }

 My guess is that the account you are using doesn't have an Enterprise subscription, which aligns with the original error you received.

Talk soon! — Jaycee

[GRajput]

Hi @JLim063 

The API is working fine, I just checked it. So, based on your error msg, I can say it must be because the account from which you have created the token doesn't have the required permission. You can try creating one from the super admin.

I hope this will help you out. Please mark it as Solution Accepted and upvote to help another Community member.
Thanks!

[GiantFocal]

Hi @JLim063,

Based on the error, this is typically one of the following issues:

1. Account tier limitation
2. Permission requirements
3. API authentication issues

You can try the following steps to ensure everything is in place:

1. Confirm your HubSpot subscription level includes role management features
2. Verify your user account has the proper administrative permissions
3. Ensure your API authentication includes all required scopes for user provisioning

[MarcosBarcelos]

Hi @JLim063 ,

Well, by the error, I recommend you see the permission of this account. You can see the configurations on the tab Account Management -> User  & Teams, Look if the account has the Super Admin permission. If you have already seen what I recommended, you can see this post https://community.hubspot.com/t5/APIs-Integrations/How-can-retrieve-roles-with-users/td-p/1018767 . Maybe it helps you with your problem.