Skip to main content
GET
/
business-units
/
v3
/
business-units
/
user
/
{userId}
Get Business Units for a user
curl --request GET \
  --url https://api.hubapi.com/business-units/v3/business-units/user/{userId} \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "logoMetadata": {
        "logoAltText": "logo sample text",
        "resizedUrl": "sillystring",
        "logoUrl": "examplelogourl.com"
      },
      "name": "sample business unit name",
      "id": "101"
    }
  ]
}
Supported products
Requires one of the following products or higher.
Marketing HubMarketing HubEnterprise
Sales HubSales HubFree
Service HubService HubFree
Content HubContent HubFree

​
Required Scopes

This API requires one of the following scopes:
  • business_units_view.read

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
userId
string
required

Identifier of user to retrieve.

Query Parameters

​
properties
string[]

The names of properties to optionally include in the response body. The only valid value is logoMetadata.

​
name
string[]

The names of Business Units to retrieve. If empty or not provided, then all associated Business Units will be returned.

Response

successful operation

A response object containing a collection of Business Units

​
results
object[]
required

The collection of Business Units