Saltar al contenido principal
POST
/
crm
/
v3
/
associations
/
{fromObjectType}
/
{toObjectType}
/
batch
/
read
Obtener múltiples asociaciones entre tipos de objetos especificados en una operación por lotes.
curl --request POST \
  --url https://api.hubapi.com/crm/v3/associations/{fromObjectType}/{toObjectType}/batch/read \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "id": "37295"
    }
  ]
}
'
{
  "completedAt": "2023-11-07T05:31:56Z",
  "results": [
    {
      "from": {
        "id": "53628"
      },
      "to": [
        {
          "id": "12726",
          "type": "contact_to_company"
        },
        {
          "id": "61352",
          "type": "contact_to_company"
        }
      ]
    }
  ],
  "startedAt": "2023-11-07T05:31:56Z",
  "status": "CANCELED",
  "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"
}

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing Hub -Gratuito
Sales HubSales Hub -Gratuito
Service HubService Hub -Gratuito
Content HubContent Hub -Gratuito

Autorizaciones

Authorization
string
header
requerido

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

Parámetros de ruta

fromObjectType
string
requerido

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

toObjectType
string
requerido

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

Cuerpo

application/json
inputs
object[]
requerido

Respuesta

successful operation

completedAt
string<date-time>
requerido

La fecha y la hora en que se completó la operación por lotes.

results
object[]
requerido
startedAt
string<date-time>
requerido

La fecha y la hora en que se inició la operación por lotes.

status
enum<string>
requerido

El estado actual de la operación por lotes, con los valores posibles: PENDIENTE, PROCESANDO, CANCELADO o COMPLETADO.

Opciones disponibles:
CANCELED,
COMPLETE,
PENDING,
PROCESSING
errors
object[]

URLs que enlazan con recursos o documentación asociados a la operación por lotes.

numErrors
integer<int32>

El número de errores encontrados durante la operación por lotes.

requestedAt
string<date-time>

La fecha y hora en que se realizó la solicitud por lotes.

Last modified on December 8, 2025