Skip to main content
PUT
/
marketing
/
v3
/
marketing-events
/
events
/
{externalEventId}
Crear o actualizar un evento de marketing
curl --request PUT \
  --url https://api.hubapi.com/marketing/v3/marketing-events/events/{externalEventId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "startDateTime": "2023-11-07T05:31:56Z",
  "customProperties": [
    {
      "sourceId": "",
      "selectedByUser": false,
      "sourceLabel": "",
      "sourceUpstreamDeployable": "<string>",
      "source": "",
      "updatedByUserId": 123,
      "persistenceTimestamp": 123,
      "sourceMetadata": "",
      "dataSensitivity": "",
      "sourceVid": "",
      "unit": "",
      "requestId": "",
      "isEncrypted": false,
      "name": "",
      "useTimestampAsPersistenceTimestamp": true,
      "value": "",
      "selectedByUserTimestamp": 123,
      "timestamp": 123,
      "isLargeValue": true
    }
  ],
  "externalAccountId": "<string>",
  "eventCancelled": true,
  "eventOrganizer": "<string>",
  "eventUrl": "<string>",
  "externalEventId": "<string>",
  "eventDescription": "<string>",
  "eventName": "<string>",
  "eventType": "<string>",
  "eventCompleted": true,
  "endDateTime": "2023-11-07T05:31:56Z"
}'
{
  "eventOrganizer": "<string>",
  "eventUrl": "<string>",
  "eventType": "<string>",
  "eventCompleted": true,
  "endDateTime": "2023-11-07T05:31:56Z",
  "createdAt": "2023-11-07T05:31:56Z",
  "startDateTime": "2023-11-07T05:31:56Z",
  "customProperties": [
    {
      "sourceId": "",
      "selectedByUser": false,
      "sourceLabel": "",
      "sourceUpstreamDeployable": "<string>",
      "source": "",
      "updatedByUserId": 123,
      "persistenceTimestamp": 123,
      "sourceMetadata": "",
      "dataSensitivity": "",
      "sourceVid": "",
      "unit": "",
      "requestId": "",
      "isEncrypted": false,
      "name": "",
      "useTimestampAsPersistenceTimestamp": true,
      "value": "",
      "selectedByUserTimestamp": 123,
      "timestamp": 123,
      "isLargeValue": true
    }
  ],
  "eventCancelled": true,
  "eventDescription": "<string>",
  "eventName": "<string>",
  "id": "<string>",
  "objectId": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z"
}
Productos compatibles
Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing HubGratuito
Sales HubSales HubGratuito
Service HubService HubGratuito
Content HubContent HubStarter

​
Ámbitos Requeridos

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

Body

application/json
​
externalAccountId
string
required

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

​
eventOrganizer
string
required

El nombre del organizador del evento de marketing.

​
externalEventId
string
required

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

​
eventName
string
required

El nombre del evento de marketing.

​
startDateTime
string<date-time>

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

​
customProperties
object[]

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.

​
eventCancelled
boolean

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

​
eventUrl
string

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

​
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"

​
eventCompleted
boolean
​
endDateTime
string<date-time>

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

Response

successful operation

​
eventOrganizer
string
required

El nombre del organizador del evento de marketing.

​
createdAt
string<date-time>
required
​
eventName
string
required

El nombre del evento de marketing.

​
id
string
required
​
updatedAt
string<date-time>
required
​
eventUrl
string

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

​
eventType
string

El tipo del evento de marketing.

​
eventCompleted
boolean
​
endDateTime
string<date-time>

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

​
startDateTime
string<date-time>

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

​
customProperties
object[]

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.

​
eventCancelled
boolean

Indica si el evento de marketing se canceló.

​
eventDescription
string

La descripción del evento de marketing.

​
objectId
string
⌘I