Skip to main content
POST
/
marketing
/
v3
/
marketing-events
/
events
/
{externalEventId}
/
complete
Marcar un evento de marketing como completado
curl --request POST \
  --url https://api.hubapi.com/marketing/v3/marketing-events/events/{externalEventId}/complete \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "startDateTime": "2023-11-07T05:31:56Z",
  "endDateTime": "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,
  "eventOrganizer": "<string>",
  "eventUrl": "<string>",
  "eventDescription": "<string>",
  "eventName": "<string>",
  "eventType": "<string>",
  "eventCompleted": true,
  "endDateTime": "2023-11-07T05:31:56Z",
  "objectId": "<string>"
}

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.

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
startDateTime
string<date-time>
required
endDateTime
string<date-time>
required

Response

successful operation

eventOrganizer
string
required

El nombre del organizador del evento de marketing.

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ó.

eventUrl
string

La 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

El tipo del evento de marketing.

eventCompleted
boolean
endDateTime
string<date-time>

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

objectId
string
I