Pular para o conteúdo principal
POST
/
marketing
/
v3
/
marketing-events
/
events
/
{externalEventId}
/
complete
Marque um evento de marketing como concluído
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 '
{
  "endDateTime": "2023-11-07T05:31:56Z",
  "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"
}

Produtos suportados

Requer um dos seguintes produtos ou superior.
Marketing HubMarketing Hub -Grátis
Sales HubSales Hub -Grátis
Service HubService Hub -Grátis
Content HubContent Hub -Grátis

Autorizações

Authorization
string
header
obrigatório

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

Parâmetros de caminho

externalEventId
string
obrigatório

Parâmetros de consulta

externalAccountId
string
obrigatório

Corpo

application/json
endDateTime
string<date-time>
obrigatório

A data e a hora de término do evento de marketing no formato ISO 8601

startDateTime
string<date-time>
obrigatório

A data e a hora de início do evento de marketing no formato ISO 8601

Resposta

successful operation

customProperties
object[]
obrigatório

Uma lista de PropertyValues. Estes podem ser qualquer tipo de nomes e valores de propriedade que você quiser. No entanto, já devem existir na definição do objeto MarketingEvent na conta da HubSpot. Se não existirem, eles serão filtrados e não definidos. Para fazer isso, você precisará criar um novo PropertyGroup no objeto MarketingEvent na conta da HubSpot para seu aplicativo específico e criar a Propriedade personalizada que deseja rastrear nessa conta da HubSpot. Não crie novas propriedades padrão no objeto MarketingEvent, pois estas serão aplicadas a todas as contas da HubSpot.

eventName
string
obrigatório

O nome do evento de marketing.

eventOrganizer
string
obrigatório

O nome do organizador do evento de marketing.

endDateTime
string<date-time>

A data e hora de término do evento de marketing.

eventCancelled
boolean

Indica se o evento de marketing foi cancelado.

eventCompleted
boolean

Indica se o evento de marketing foi concluído.

eventDescription
string

A descrição do evento de marketing.

eventType
string

O tipo do evento de marketing.

eventUrl
string

O URL no aplicativo de eventos externos onde o evento de marketing pode ser gerenciado.

objectId
string

O ID do objeto do CRM do evento de marketing

startDateTime
string<date-time>

A data e hora de início do evento de marketing.

Last modified on March 24, 2026