Pular para o conteúdo principal
POST
Fazer upsert de objetos em lote

Supported products

Autorizações

Authorization
string
header
obrigatório

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

Parâmetros de caminho

objectType
string
obrigatório

O tipo de objeto do CRM a ser criado ou atualizado em lote. Ele especifica a categoria de objetos, como contatos ou oportunidades, aos quais a operação se destinará.

Corpo

application/json

Representa uma operação de entrada em lote para fazer upsert de objetos públicos simples no HubSpot. Este componente é usado para processar várias operações de upsert em uma única solicitação, melhorando a eficiência e o desempenho.

inputs
object[]
obrigatório

Uma matriz de objetos SimplePublicObjectBatchInputUpsert, cada um representando um objeto a ser criado ou atualizado. Este é um campo obrigatório.

Resposta

successful operation

Representa o resultado de uma operação de upsert em lote, incluindo o status da operação, carimbos de data/hora e uma lista de objetos criados ou atualizados com sucesso.

completedAt
string<date-time>
obrigatório

A data e hora em que a operação em lote foi concluída, no formato ISO 8601.

results
object[]
obrigatório

Uma matriz de objetos que representa os resultados da operação de upsert em lote. Cada objeto corresponde a um objeto do CRM que foi criado ou atualizado.

startedAt
string<date-time>
obrigatório

A data e a hora em que a operação em lote foi iniciada, no formato ISO 8601.

status
enum<string>
obrigatório

O status atual da operação em lote. Os valores válidos incluem 'PENDENTE', 'PROCESSANDO', 'CANCELADO' e 'CONCLUÍDO'.

Opções disponíveis:
CANCELED,
COMPLETE,
PENDING,
PROCESSING

Um mapa de nomes de links para URIs associadas, fornecendo informações ou ações adicionais relacionadas à operação em lote.

requestedAt
string<date-time>

A data e a hora em que a operação em lote foi solicitada, no formato ISO 8601.

Última modificação em 6 de outubro de 2026