# Getting User Permissions from API

**URL:** <https://community.hubspot.com/t/getting-user-permissions-from-api/40878>\
**Category:** APIs & Integrations\
**Tags:** developer-tools, free\
**Created:** [July 16, 2021, 5:25pm UTC](https://community.hubspot.com/t/getting-user-permissions-from-api/40878 "2021-07-16T17:25:44Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![MJin](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/mjin/32/61905_2.png) [@MJin](https://community.hubspot.com/u/MJin)\
**Post date:** [July 16, 2021, 5:25pm UTC](https://community.hubspot.com/t/getting-user-permissions-from-api/40878/1 "2021-07-16T17:25:44Z")

</div>

Hello,

I have seen this question asked several times over the years, but was wondering if there have been any updates since.

Is it still not possible to retrieve user permissions (like Super Admin, Contacts, Sales, etc) from the API?

I have tried making calls to the Users Provisioning API because the roleId property sounded interesting, but I only received an error message “Account doesn’t have access to roles” (I have a free account). Even if I made a successful call, I’m not sure how to interpret the roleId.

I have also made GET requests to the v2 Owners API to see the hasContactsAccess property, which I assumed to be set to true for any user that had access to an account’s contacts. I was surprised to see that hasContactsAccess was set to false for myself, even though I am a Super Admin, so it seems I am misunderstanding this property.

If anyone can shed some light on any of these things, I would be extremely grateful. Thank you for the help!

---

<div class="post-metadata">

**Author:** ![dennisedson](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/dennisedson/32/28044_2.png) [@dennisedson](https://community.hubspot.com/u/dennisedson)\
**Post date:** [July 16, 2021, 8:05pm UTC](https://community.hubspot.com/t/getting-user-permissions-from-api/40878/2 "2021-07-16T20:05:59Z")

</div>

@himanshurauthan any thoughts on this 😀

---

<div class="post-metadata">

**Author:** ![himanshurauthan](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/himanshurauthan/32/53076_2.png) [@himanshurauthan](https://community.hubspot.com/u/himanshurauthan)\
**Post date:** [July 19, 2021, 12:25pm UTC](https://community.hubspot.com/t/getting-user-permissions-from-api/40878/3 "2021-07-19T12:25:13Z")

</div>

Hi @MJin,

The User Provisioning API has expanded since 2021. Check the current subscription and scope requirements for the specific operation rather than assuming the entire API is Enterprise-only.

More details here - [Create and assign permission sets](https://knowledge.hubspot.com/settings/create-roles)

After this API call, you will get the roleId as mentioned in the doc. HubSpot now offers additional user and permissions APIs, but these don’t necessarily provide a complete role definition from a `roleId`.

This is how I made this work for 1 of our customers -

We have a local database of role details and roleId, and I’m using that as a reference to match the roleId.

Hope this helps,

Regards,

_Moderator Note: this post was reviewed for relevancy and optimized for clarity on October 23, 2026. Thank you for your contributions to the HubSpot Community!_

---

<div class="post-metadata">

**Author:** ![MJin](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/mjin/32/61905_2.png) [@MJin](https://community.hubspot.com/u/MJin)\
**Post date:** [July 19, 2021, 2:51pm UTC](https://community.hubspot.com/t/getting-user-permissions-from-api/40878/4 "2021-07-19T14:51:44Z")

</div>

I was not aware that the users provisioning API only applies to Enterprise accounts. Thank you!

---

<div class="post-metadata">

**Author:** ![RJChavda](https://avatars.discourse-cdn.com/v4/letter/r/898d66/32.png) [@RJChavda](https://community.hubspot.com/u/RJChavda)\
**Post date:** [October 1, 2024, 1:59pm UTC](https://community.hubspot.com/t/getting-user-permissions-from-api/40878/5 "2024-10-01T13:59:05Z")

</div>

Here, you need to pass your user ID and your API token key.

 ![RJChavda_0-1727791112082.png](https://d2qpr2jzcazej7.cloudfront.net/original/3X/d/5/d57005d50f997d971f76d0f1ca9ce414b40386f1.png)

```lia-code-sample
curl --location 'https://api.hubapi.com/crm/v3/objects/users/362859434635?properties=hs_access%2Chs_assigned_seats%2Chs_family_name%2Chs_given_name%2Chs_email' \
--header 'Authorization: Bearer your_key_here' \
--header 'Accept: application/json' \
--data ''

```