Skip to main content
GET
/
settings
/
v3
/
users
Retrieves a list of users from an account
curl --request GET \
  --url https://api.hubapi.com/settings/v3/users/ \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "id": "123",
      "email": "newUser@email.com",
      "roleId": "100",
      "primaryTeamId": "101",
      "secondaryTeamIds": [
        "102"
      ],
      "superAdmin": "false"
    }
  ],
  "paging": {
    "next": {
      "after": "<string>",
      "link": "<string>"
    }
  }
}

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.

Query Parameters

after
string

Results will display maximum 100 users per page. Additional results will be on the next page.

limit
integer<int32>

The number of users to retrieve

Response

successful operation

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