Skip to main content
POST
Obtener un lote de elementos del catálogo de precios

Supported products

Autorizaciones

Authorization
string
header
requerido

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

FlowAuthorization Code
Authorization URL
https://app.hubspot.com/oauth/authorize
Token URL
https://api.hubapi.com/oauth/v1/token
Scopes1
oauth

Parámetros de ruta

objectType
string
requerido

El tipo de objeto del CRM que se leerá en lote, como contactos, empresas o negocios.

Parámetros de consulta

archived
boolean
predeterminado:false

Si se devuelven solo los resultados que se han archivado. La opción predeterminada es falso.

Cuerpo

application/json

Specifies the input for reading a batch of CRM objects, including arrays of object IDs, requested property names (with optional history), and an optional unique identifying property.

inputs
object[]
requerido

Un conjunto de objetos SimplePublicObjectId, cada uno de los cuales contiene un campo "id" que especifica el ID interno de un objeto que se va a leer.

properties
string[]
requerido

Un conjunto de cadenas que representan las propiedades que se devolverán para cada objeto. Si una propiedad especificada no está presente en los objetos solicitados, se ignorará.

propertiesWithHistory
string[]
requerido

Un conjunto de cadenas que representan las propiedades que se devolverán junto con su historial de valores anteriores. Si una propiedad especificada no está presente en los objetos solicitados, se ignorará.

idProperty
string

Una cadena que representa el nombre de una propiedad cuyos valores son únicos para este tipo de objeto. Esta propiedad se usa para identificar objetos de forma única.

Respuesta

successful operation

A public object batch response object

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 elementos SimplePublicObject que representan los resultados de la operación por lotes.

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 con URI asociados, que puede proporcionar 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