Skip to main content
GET
/
crm
/
v4
/
objects
/
{objectType}
/
{objectId}
/
associations
/
{toObjectType}
List
curl --request GET \
  --url https://api.hubapi.com/crm/v4/objects/{objectType}/{objectId}/associations/{toObjectType} \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "associationTypes": [
        {
          "category": "HUBSPOT_DEFINED",
          "typeId": 123,
          "label": "<string>"
        }
      ],
      "toObjectId": "<string>"
    }
  ],
  "paging": {
    "next": {
      "after": "<string>",
      "link": "<string>"
    },
    "prev": {
      "before": "<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 -Starter

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
objectId
string
required

The unique identifier for the source object whose associations are being retrieved.

​
objectType
string
required

Specifies the type of the source object in the association.

​
toObjectType
string
required

Specifies the type of the target object in the association.

Query Parameters

​
after
string

The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results.

​
limit
integer<int32>
default:500

The maximum number of results to display per page.

Response

successful operation

​
results
object[]
required
​
paging
object