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 '
[
  {
    "associationCategory": "HUBSPOT_DEFINED",
    "associationTypeId": 123
  }
]
'
{
  "fromObjectId": "<string>",
  "fromObjectTypeId": "<string>",
  "labels": [
    "<string>"
  ],
  "toObjectId": "<string>",
  "toObjectTypeId": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://br.developers.hubspot.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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

O identificador exclusivo do objeto de origem na associação a ser criado.

objectType
string
obrigatório

Especifica o tipo de objeto de origem na associação a ser criado.

toObjectId
string
obrigatório

O identificador exclusivo do objeto de destino na associação a ser criado.

toObjectType
string
obrigatório

Especifica o tipo de objeto de destino na associação a ser criado.

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.

Last modified on April 13, 2026