Saltar al contenido principal
POST
/
marketing
/
v3
/
marketing-events
/
events
/
{externalEventId}
/
{subscriberState}
/
upsert
Registrar un estado del suscriptor por ID de contacto
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"
  }
}

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

externalEventId
string
requerido

El ID del evento de marketing en la aplicación de eventos externos

subscriberState
string
requerido

El nuevo estado del suscriptor para los contactos de HubSpot y el evento de marketing especificado. Por ejemplo: "registrarse", "asistir" o "cancelar".

Parámetros de consulta

externalAccountId
string
requerido

El accountId que está asociado con este evento de marketing en la aplicación de eventos externos

Cuerpo

application/json
inputs
object[]
requerido

Lista de contactos de HubSpot para suscribir al evento de marketing

Respuesta

default - */*
category
string
requerido

La categoría del error

correlationId
string<uuid>
requerido

Un identificador único para la solicitud. Incluye este valor con cualquier informe de error o ticket de asistencia.

Ejemplo:

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

message
string
requerido

Un mensaje legible en el que se describa el error y los pasos para solucionarlo, si procede.

Ejemplo:

"An error occurred"

context
object

Contexto de la condición de error

Ejemplo:

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

errors
object[]

información adicional acerca del error

Un mapa de nombres de enlaces a URI asociadas que contienen documentación sobre el error o los pasos recomendados para solucionarlo.

subCategory
string

Una categoría específica que contiene detalles más concretos acerca del error

Last modified on December 9, 2025