Saltar al contenido principal
POST
/
marketing
/
v3
/
marketing-events
/
events
Crear un evento de marketing
curl --request POST \
  --url https://api.hubapi.com/marketing/v3/marketing-events/events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customProperties": [
    {
      "dataSensitivity": "high",
      "isEncrypted": true,
      "isLargeValue": true,
      "name": "<string>",
      "persistenceTimestamp": 123,
      "requestId": "<string>",
      "selectedByUser": true,
      "selectedByUserTimestamp": 123,
      "source": "ACADEMY",
      "sourceId": "<string>",
      "sourceLabel": "<string>",
      "sourceMetadata": "<string>",
      "sourceUpstreamDeployable": "<string>",
      "sourceVid": [
        123
      ],
      "timestamp": 123,
      "unit": "<string>",
      "updatedByUserId": 123,
      "useTimestampAsPersistenceTimestamp": true,
      "value": "<string>"
    }
  ],
  "eventName": "<string>",
  "eventOrganizer": "<string>",
  "externalAccountId": "<string>",
  "externalEventId": "<string>",
  "endDateTime": "2023-11-07T05:31:56Z",
  "eventCancelled": true,
  "eventCompleted": true,
  "eventDescription": "<string>",
  "eventType": "<string>",
  "eventUrl": "<string>",
  "startDateTime": "2023-11-07T05:31:56Z"
}
'
{
  "customProperties": [
    {
      "dataSensitivity": "high",
      "isEncrypted": true,
      "isLargeValue": true,
      "name": "<string>",
      "persistenceTimestamp": 123,
      "requestId": "<string>",
      "selectedByUser": true,
      "selectedByUserTimestamp": 123,
      "source": "ACADEMY",
      "sourceId": "<string>",
      "sourceLabel": "<string>",
      "sourceMetadata": "<string>",
      "sourceUpstreamDeployable": "<string>",
      "sourceVid": [
        123
      ],
      "timestamp": 123,
      "unit": "<string>",
      "updatedByUserId": 123,
      "useTimestampAsPersistenceTimestamp": true,
      "value": "<string>"
    }
  ],
  "eventName": "<string>",
  "eventOrganizer": "<string>",
  "endDateTime": "2023-11-07T05:31:56Z",
  "eventCancelled": true,
  "eventCompleted": true,
  "eventDescription": "<string>",
  "eventType": "<string>",
  "eventUrl": "<string>",
  "objectId": "<string>",
  "startDateTime": "2023-11-07T05:31:56Z"
}

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.

Cuerpo

application/json
customProperties
object[]
requerido

Una lista de PropertyValues. Pueden ser cualquier tipo de nombres y valores de propiedad que desees. Sin embargo, deben existir previamente en la definición del objeto MarketingEvent de la cuenta de HubSpot. Si no es así, serán filtrados y no se establecerán. Para hacer esto, deberás crear un nuevo PropertyGroup en el objeto MarketingEvent de la cuenta de HubSpot para tu aplicación específica y crear la Propiedad Personalizada a la que deseas hacer seguimiento en esa cuenta de HubSpot. No crees ninguna propiedad predeterminada nueva en el objeto MarketingEvent, ya que esa propiedad se aplicará a todas las cuentas de HubSpot.

eventName
string
requerido

El nombre del evento de marketing.

eventOrganizer
string
requerido

El nombre del organizador del evento de marketing.

externalAccountId
string
requerido

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

externalEventId
string
requerido

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

endDateTime
string<date-time>

La fecha y la hora de finalización del evento de marketing.

eventCancelled
boolean

Indica si el evento de marketing se canceló. Por opción predeterminada, se establece en "falso".

eventCompleted
boolean

Indica si el evento de marketing finalizó. Por opción predeterminada, se define como false.

eventDescription
string

La descripción del evento de marketing.

eventType
string

Describe el tipo de evento del que se trata. Por ejemplo: "WEBINARIO", "CONFERENCIA", "TALLER"

eventUrl
string

Una URL en la aplicación de eventos externos donde se puede gestionar el evento de marketing.

startDateTime
string<date-time>

La fecha y la hora de inicio del evento de marketing.

Respuesta

successful operation

customProperties
object[]
requerido

Una lista de PropertyValues. Pueden ser cualquier tipo de nombres y valores de propiedad que desees. Sin embargo, deben existir previamente en la definición del objeto MarketingEvent de la cuenta de HubSpot. Si no es así, serán filtrados y no se establecerán. Para hacer esto, deberás crear un nuevo PropertyGroup en el objeto MarketingEvent de la cuenta de HubSpot para tu aplicación específica y crear la Propiedad Personalizada a la que deseas hacer seguimiento en esa cuenta de HubSpot. No crees ninguna propiedad predeterminada nueva en el objeto MarketingEvent, ya que esa propiedad se aplicará a todas las cuentas de HubSpot.

eventName
string
requerido

El nombre del evento de marketing.

eventOrganizer
string
requerido

El nombre del organizador del evento de marketing.

endDateTime
string<date-time>

La fecha y la hora de finalización del evento de marketing.

eventCancelled
boolean

Indica si el evento de marketing se canceló.

eventCompleted
boolean

Indica si el evento de marketing se ha completado.

eventDescription
string

La descripción del evento de marketing.

eventType
string

El tipo del evento de marketing.

eventUrl
string

La URL en la aplicación de eventos externos donde se puede gestionar el evento de marketing.

objectId
string

ID del objeto del CRM del evento de marketing

startDateTime
string<date-time>

La fecha y la hora de inicio del evento de marketing.

Last modified on December 9, 2025