Skip to main content
PUT
/
crm-associations
/
v1
/
associations
Associate CRM objects
curl --request PUT \
  --url https://api.hubapi.com/crm-associations/v1/associations \
  --header 'Content-Type: application/json' \
  --data '
{
  "fromObjectId": "<string>",
  "toObjectId": "<string>",
  "category": "<string>",
  "definitionId": "<string>"
}
'
{
  "fromObjectId": 496346,
  "toObjectId": 176602,
  "category": "HUBSPOT_DEFINED",
  "definitionId": 15
}

Body

application/json
fromObjectId
string
required

The ID of the object being associated.

toObjectId
string
required

The ID of the object the from object is being associated with.

category
string
required

The category of the association. Currently this must be "HUBSPOT_DEFINED"

definitionId
string
required

The ID of the association definition. See the table on the overview page for a list of these IDs.

Response

200 - application/json

Successful response - This endpoint is used to associate two CRM objects

The response is of type object.

Last modified on March 30, 2026