Skip to main content
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": {},
      "properties": {},
      "email": "<string>",
      "interactionDateTime": 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 -Starter
Esta API requiere uno de los siguientes ámbitos:
crm.objects.marketing_events.write

Authorizations

Authorization
string
header
required

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

Path Parameters

externalEventId
string
required

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

subscriberState
string
required

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

Query Parameters

externalAccountId
string
required

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

Body

application/json
inputs
object[]
required

Lista de detalles de eventos de marketing para crear o actualizar

Response

default - */*

An error occurred.

correlationId
string<uuid>
required

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

Example:

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

message
string
required

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

Example:

"Invalid input (details will vary based on the error)"

category
string
required

La categoría del error

Example:

"VALIDATION_ERROR"

subCategory
string

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

context
object

Contexto de la condición de error

Example:

"{\"missingScopes\":[\"scope1\",\"scope2\"],\"invalidPropertyName\":[\"propertyValue\"]}"

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

Example:

"{\"knowledge-base\":\"https://www.hubspot.com/products/service/knowledge-base\"}"

errors
object[]

información adicional acerca del error

I