Crea un lote de leads

Crea varios registros de leads en una sola solicitud proporcionando un lote de datos de leads. Este punto de terminación permite crear leads de manera eficiente al procesarlos juntos, lo que puede ser útil para sincronizar datos de otros sistemas o importar grandes conjuntos de datos.

POST /crm/v3/objects/leads/batch/create

Crea un lote de leads

cURL

curl --request POST \
  --url https://api.hubapi.com/crm/v3/objects/leads/batch/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "associations": [
        {
          "to": {
            "id": "<string>"
          },
          "types": [
            {
              "associationCategory": "HUBSPOT_DEFINED",
              "associationTypeId": 123
            }
          ]
        }
      ],
      "properties": {},
      "objectWriteTraceId": "<string>"
    }
  ]
}
'

201

{
  "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

201

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.