Pular para o conteúdo principal
POST
/
marketing
/
v3
/
marketing-events
/
events
/
{externalEventId}
/
{subscriberState}
/
upsert
Registrar um estado de assinante pelo ID de contato
curl --request POST \
  --url https://api.hubapi.com/marketing/v3/marketing-events/events/{externalEventId}/{subscriberState}/upsert \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "interactionDateTime": 123,
      "properties": {},
      "vid": 123
    }
  ]
}
'
{
  "message": "Invalid input (details will vary based on the error)",
  "correlationId": "aeb5f871-7f07-4993-9211-075dc63e7cbf",
  "category": "VALIDATION_ERROR",
  "links": {
    "knowledge-base": "https://www.hubspot.com/products/service/knowledge-base"
  }
}

Produtos suportados

Requer um dos seguintes produtos ou superior.
Marketing HubMarketing Hub -Grátis
Sales HubSales Hub -Grátis
Service HubService Hub -Grátis
Content HubContent Hub -Grátis

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

externalEventId
string
obrigatório
subscriberState
string
obrigatório

Parâmetros de consulta

externalAccountId
string
obrigatório

Corpo

application/json
inputs
object[]
obrigatório

Lista de contatos do HubSpot para inscrever no evento de marketing

Resposta

default - */*
category
string
obrigatório

A categoria de erro

correlationId
string<uuid>
obrigatório

Um identificador exclusivo para a solicitação. Inclua este valor em relatórios de erro ou tickets de suporte

Exemplo:

"aeb5f871-7f07-4993-9211-075dc63e7cbf"

message
string
obrigatório

Uma mensagem legível por humanos que descreve o erro, juntamente com as etapas de correção, quando apropriado

Exemplo:

"An error occurred"

context
object

Contexto sobre a condição do erro

Exemplo:

"{invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]}"

errors
object[]

mais informações sobre o erro

Um mapa de nomes de links para URIs associados que contêm documentação sobre o erro ou etapas de correção recomendadas

subCategory
string

Uma categoria específica que contém mais detalhes específicos sobre o erro

Last modified on March 24, 2026