topic Re: Roles Endpoint Error in APIs & Integrations

Roles Endpoint Error

JLim063 — Fri, 09 May 2025 22:50:01 GMT

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%2Fv3%2Fusers%2Froles`

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?

Re: Roles Endpoint Error

MarcosBarcelos — Sat, 10 May 2025 17:20:09 GMT

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.

Re: Roles Endpoint Error

GiantFocal — Sun, 11 May 2025 04:38:15 GMT

Hi @JLim063,

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

Account tier limitation
Permission requirements
API authentication issues

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

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

Re: Roles Endpoint Error

GRajput — Mon, 19 May 2025 14:22:30 GMT

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!

Re: Roles Endpoint Error

Jaycee_Lewis — Fri, 23 May 2025 17:10:44 GMT

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