Saltar al contenido principal
POST
/
marketing
/
v3
/
marketing-events
/
events
/
{externalEventId}
/
{subscriberState}
/
email-upsert
Registrar un estado del suscriptor por correo del contacto
curl --request POST \
  --url https://api.hubapi.com/marketing/v3/marketing-events/events/{externalEventId}/{subscriberState}/email-upsert \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "contactProperties": {},
      "email": "<string>",
      "interactionDateTime": 123,
      "properties": {}
    }
  ]
}
'
{
  "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"
  }
}

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

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 detalles de eventos de marketing para crear o actualizar

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 las 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 April 13, 2026