Pular para o conteúdo principal
PUT
/
crm
/
objects
/
2026-03
/
{objectType}
/
{objectId}
/
associations
/
{toObjectType}
/
{toObjectId}
Associar registros (rotulados)
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
  }
]
'
{
  "fromObjectId": "<string>",
  "fromObjectTypeId": "<string>",
  "labels": [
    "<string>"
  ],
  "toObjectId": "<string>",
  "toObjectTypeId": "<string>"
}

Supported products

Autorizações

Authorization
string
header
obrigatório

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

Parâmetros de caminho

objectId
string
obrigatório
objectType
string
obrigatório
toObjectId
string
obrigatório
toObjectType
string
obrigatório

Corpo

application/json
associationCategory
enum<string>
obrigatório

A categoria da associação, por exemplo, "HUBSPOT_DEFINED".

Opções disponíveis:
HUBSPOT_DEFINED,
INTEGRATOR_DEFINED,
USER_DEFINED,
WORK
associationTypeId
integer<int32>
obrigatório

O ID que representa o tipo específico de associação.

Resposta

successful operation

Os descritores de relacionamento aplicáveis entre dois tipos de objeto.

fromObjectId
string
obrigatório

O ID do objeto de origem na associação.

fromObjectTypeId
string
obrigatório

O ID do tipo do objeto de origem na associação.

labels
string[]
obrigatório

Uma série de rótulos associados à relação entre os objetos.

toObjectId
string
obrigatório

O ID do objeto de destino na associação.

toObjectTypeId
string
obrigatório

O ID do tipo do objeto de destino na associação.

Última modificação em 10 de abril de 2026