Associate records (labeled)

Establece etiquetas de asociación entre dos registros.

PUT /crm/objects/2026-03/{objectType}/{objectId}/associations/{toObjectType}/{toObjectId}

Asociar registros (etiquetados)

cURL

curl --request PUT \
  --url https://api.hubapi.com/crm/objects/2026-03/{objectType}/{objectId}/associations/{toObjectType}/{toObjectId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "associationTypeId": 123
  }
]
'

201

{
  "fromObjectId": "<string>",
  "fromObjectTypeId": "<string>",
  "labels": [
    "<string>"
  ],
  "toObjectId": "<string>",
  "toObjectTypeId": "<string>"
}

Supported products

Required Scopes

Autorizaciones

oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2oauth2

Authorization · string · header · requerido

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

Parámetros de ruta

objectId · string · requerido

objectType · string · requerido

toObjectId · string · requerido

toObjectType · string · requerido

Cuerpo

application/json

associationCategory · enum<string> · requerido

La categoría de la asociación, por ejemplo, "HUBSPOT_DEFINED"

Opciones disponibles: HUBSPOT_DEFINED, INTEGRATOR_DEFINED, USER_DEFINED, WORK

associationTypeId · integer<int32> · requerido

El ID que representa el tipo de asociación específica.

Respuesta

201

application/json

successful operation

Los descriptores de relación aplicables entre dos tipos de objeto.

fromObjectId · string · requerido

El ID del objeto de origen en la asociación.

fromObjectTypeId · string · requerido

El tipo de ID del objeto de origen en la asociación.

labels · string[] · requerido

Un conjunto de etiquetas asociadas con la relación entre los objetos.

toObjectId · string · requerido

El ID del objeto de destino en la asociación.

toObjectTypeId · string · requerido

El tipo de ID del objeto de destino en la asociación.