Saltar al contenido principal
POST
Insertar o actualizar objetos por lotes

Supported products

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

El tipo de objeto del CRM que se creará o actualizará en lote. Esto especifica la categoría de objetos, como contactos o negocios, a la que se dirigirá la operación.

Cuerpo

application/json

Representa una operación de entrada por lotes para insertar o actualizar objetos públicos simples en HubSpot. Este componente se usa para procesar varias operaciones de inserción o actualización en una sola solicitud, lo que mejora la eficiencia y el rendimiento.

inputs
object[]
requerido

Un conjunto de objetos SimplePublicObjectBatchInputUpsert, cada uno de los cuales representa un objeto que se va a crear o actualizar. Este es un campo obligatorio.

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 fecha y hora en que se completó la operación por lotes, en formato ISO 8601.

results
object[]
requerido

Un conjunto de objetos que representan los resultados de la operación de inserción/actualización por lotes. Cada objeto corresponde a un objeto del CRM que se creó o actualizó.

startedAt
string<date-time>
requerido

La fecha y la hora en que comenzó la operación por lotes, en formato ISO 8601.

status
enum<string>
requerido

El estado actual de la operación por lotes. Los valores válidos son "PENDING", "PROCESSING", "CANCELED" y "COMPLETE".

Opciones disponibles:
CANCELED,
COMPLETE,
PENDING,
PROCESSING

Un mapa de nombres de enlaces a URI asociados, que proporciona información o acciones adicionales relacionadas con la operación por lotes.

requestedAt
string<date-time>

La fecha y la hora en que se solicitó la operación por lotes, en formato ISO 8601.

Última modificación el 6 de octubre de 2026