Actualiza un lote de leads por ID interno o valores de propiedad únicos

Actualizar varios registros de leads usando sus ID internos o valores de propiedad únicos. Este punto de terminación permite el procesamiento por lotes de actualizaciones, donde las propiedades de cada lead pueden modificarse en función de la entrada proporcionada. Asegúrate de que las propiedades que se están actualizando existan en los objetos de leads para evitar errores.

POST /crm/v3/objects/leads/batch/update

Actualiza un lote de leads por ID interno o valores de propiedad únicos

cURL

curl --request POST \
  --url https://api.hubapi.com/crm/v3/objects/leads/batch/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "id": "<string>",
      "properties": {},
      "idProperty": "my_unique_property_name",
      "objectWriteTraceId": "<string>"
    }
  ]
}
'

200

{
  "completedAt": "2023-11-07T05:31:56Z",
  "results": [
    {
      "archived": false,
      "createdAt": "2019-10-30T03:30:17.883Z",
      "id": "512",
      "properties": {
        "property_checkbox": "false",
        "property_date": "1572480000000",
        "property_dropdown": "choice_b",
        "property_multiple_checkboxes": "chocolate;strawberry",
        "property_number": "17",
        "property_radio": "option_1",
        "property_string": "value"
      },
      "updatedAt": "2019-12-07T16:50:06.678Z"
    }
  ],
  "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 Hub -Gratuito

Sales Hub -Pro

Service Hub -Gratuito

Content Hub -Gratuito

Ámbitos Requeridos

Autorizaciones

oauth2private_apps

Authorization · string · header · requerido

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

Cuerpo

application/json

inputs · object[] · requerido

Show child attributes

Respuesta

200

application/json

successful operation

Un objeto de respuesta de lote de objetos públicos

completedAt · string<date-time> · requerido

La marca de tiempo en que se completó el procesamiento por lotes, en formato ISO 8601.

results · object[] · requerido

Show child attributes

startedAt · string<date-time> · requerido

La marca de tiempo en que comenzó el procesamiento por lotes, en formato ISO 8601.

status · enum<string> · requerido

El estado actual de la solicitud de procesamiento por lotes, puede ser "PENDIENTE", "PROCESANDO", "CANCELADO" o "COMPLETADO".

Opciones disponibles: CANCELED, COMPLETE, PENDING, PROCESSING

errors · object[]

Show child attributes

links · object

Un objeto que contiene los enlaces relacionados con la solicitud por lotes.

Show child attributes

numErrors · integer<int32>

El número total de errores que se produjeron durante la operación por lotes.

requestedAt · string<date-time>

La marca de tiempo en la que se realizó inicialmente la solicitud por lotes, en formato ISO 8601.