Saltar al contenido principal
POST
/
crm
/
objects
/
v3
/
{objectType}
/
batch
/
upsert
Crea o actualiza un lote de citas por valores de propiedad únicos
curl --request POST \
  --url https://api.hubapi.com/crm/objects/v3/{objectType}/batch/upsert \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "id": "<string>",
      "properties": {},
      "idProperty": "<string>",
      "objectWriteTraceId": "<string>"
    }
  ]
}
'
{
  "completedAt": "2023-11-07T05:31:56Z",
  "results": [
    {
      "archived": true,
      "createdAt": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "new": true,
      "properties": {},
      "updatedAt": "2023-11-07T05:31:56Z",
      "archivedAt": "2023-11-07T05:31:56Z",
      "objectWriteTraceId": "<string>",
      "propertiesWithHistory": {},
      "url": "<string>"
    }
  ],
  "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": 10,
  "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

objectType
string
requerido

objectTypeId del tipo de objeto

Cuerpo

application/json
inputs
object[]
requerido

Respuesta

successful operation

Representa el resultado de una operación de inserción o actualización por lotes, que incluye el estado de la operación, las marcas de tiempo y una lista de objetos creados o actualizados con éxito.

completedAt
string<date-time>
requerido

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

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

La marca de tiempo en que comenzó la ejecución del 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[]

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

numErrors
integer<int32>

Número de errores.

Ejemplo:

10

requestedAt
string<date-time>

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

Last modified on March 30, 2026