Pular para o conteúdo principal
PUT
/
crm
/
objects
/
2026-03
/
{fromObjectType}
/
{fromObjectId}
/
associations
/
default
/
{toObjectType}
/
{toObjectId}
Associar registros (padrão)
curl --request PUT \
  --url https://api.hubapi.com/crm/objects/2026-03/{fromObjectType}/{fromObjectId}/associations/default/{toObjectType}/{toObjectId} \
  --header 'Authorization: Bearer <token>'
{
  "completedAt": "2023-11-07T05:31:56Z",
  "results": [
    {
      "associationSpec": {
        "associationTypeId": 123
      },
      "from": {
        "id": "<string>"
      },
      "to": {
        "id": "<string>"
      }
    }
  ],
  "startedAt": "2023-11-07T05:31:56Z",
  "errors": [
    {
      "category": "<string>",
      "context": {},
      "errors": [
        {
          "message": "<string>",
          "code": "<string>",
          "context": "{missingScopes=[scope1, scope2]}",
          "in": "<string>",
          "subCategory": "<string>"
        }
      ],
      "links": {},
      "message": "<string>",
      "status": "<string>",
      "id": "<string>",
      "subCategory": {}
    }
  ],
  "links": {},
  "numErrors": 123,
  "requestedAt": "2023-11-07T05:31:56Z"
}

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

fromObjectId
string
obrigatório
fromObjectType
string
obrigatório
toObjectId
string
obrigatório
toObjectType
string
obrigatório

Resposta

successful operation

A resposta retornada após a realização de uma operação em lote nas associações.

completedAt
string<date-time>
obrigatório

A data e hora em que o processo em lote foi concluído, no formato ISO 8601.

results
object[]
obrigatório
startedAt
string<date-time>
obrigatório

A data e hora em que o processamento em lote começou a ser executado, no formato ISO 8601.

status
enum<string>
obrigatório

O status da solicitação de processamento em lote: "PENDENTE", "PROCESSANDO", "CANCELADO" ou "CONCLUÍDO".

Opções disponíveis:
CANCELED,
COMPLETE,
PENDING,
PROCESSING
errors
object[]

Um objeto contendo links relevantes relacionados à solicitação em lote.

numErrors
integer<int32>

O número de erros encontrados durante o processamento em lote.

requestedAt
string<date-time>

A data e hora em que o processo em lote foi iniciado, no formato ISO 8601.

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