Account & Settings
Gestión de aplicaciones
Autenticación
Automatización
CMS
Communication preferences
Conversaciones
Marketing
- API de marketing | Eventos de marketing
- POSTCreate an event
- GETRetrieve event by HubSpot ID
- GETRetrieve event by external ID
- GETRetrieve all events
- PATCHPartially update event by external ID
- PATCHUpdate event by HubSpot ID
- PUTUpdate event by external ID
- DELDelete event by external ID
- DELDelete event by HubSpot ID
Scheduler
curl --request POST \
--url https://api.hubapi.com/marketing/marketing-events/2026-03/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"
}
}Record a subscriber state by contact email
Registra el estado de un suscriptor entre múltiples contactos de HubSpot y un evento de marketing, utilizando las direcciones de correo electrónico de los contactos. Ten en cuenta que el contacto debe existir previamente en HubSpot; no se creará un contacto. El campo contactProperties se usa solo al crear un nuevo contacto. Estas propiedades no actualizarán los contactos existentes.
curl --request POST \
--url https://api.hubapi.com/marketing/marketing-events/2026-03/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"
}
}Documentation Index
Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt
Use this file to discover all available pages before exploring further.
Supported products
Supported products
Required Scopes
Required Scopes
Autorizaciones
The access token received from the authorization server in the OAuth 2.0 flow.
Parámetros de consulta
Cuerpo
Lista de detalles de eventos de marketing para crear o actualizar
Show child attributes
Show child attributes
Respuesta
La categoría del error
Un identificador único para la solicitud. Incluye este valor con cualquier informe de error o ticket de asistencia.
"aeb5f871-7f07-4993-9211-075dc63e7cbf"
Un mensaje legible en el que se describa el error y los pasos para solucionarlo, si procede
"An error occurred"
Contexto de la condición de error
Show child attributes
Show child attributes
"{invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]}"
información adicional acerca del error
Show child attributes
Show child attributes
Un mapa de nombres de enlaces a las URI asociadas que contienen documentación sobre el error o los pasos recomendados para solucionarlo
Show child attributes
Show child attributes
Una categoría específica que contiene detalles más concretos acerca del error