Atualizar vários eventos de marketing por ObjectId

curl --request POST \
  --url https://api.hubapi.com/marketing/v3/marketing-events/batch/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "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>"
        }
      ],
      "objectId": "<string>",
      "endDateTime": "2023-11-07T05:31:56Z",
      "eventCancelled": true,
      "eventDescription": "<string>",
      "eventName": "<string>",
      "eventOrganizer": "<string>",
      "eventType": "<string>",
      "eventUrl": "<string>",
      "startDateTime": "2023-11-07T05:31:56Z"
    }
  ]
}
'

{
  "completedAt": "2023-11-07T05:31:56Z",
  "results": [
    {
      "createdAt": "2023-11-07T05:31:56Z",
      "customProperties": [
        {
          "name": "<string>",
          "value": "<string>"
        }
      ],
      "eventName": "<string>",
      "objectId": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z",
      "appInfo": {
        "id": "<string>",
        "name": "<string>"
      },
      "endDateTime": "2023-11-07T05:31:56Z",
      "eventCancelled": true,
      "eventCompleted": true,
      "eventDescription": "<string>",
      "eventOrganizer": "<string>",
      "eventType": "<string>",
      "eventUrl": "<string>",
      "startDateTime": "2023-11-07T05:31:56Z"
    }
  ],
  "startedAt": "2023-11-07T05:31:56Z",
  "status": "CANCELED",
  "links": {},
  "requestedAt": "2023-11-07T05:31:56Z"
}

POST

marketing

marketing-events

batch

update

Atualizar vários eventos de marketing por ObjectId

curl --request POST \
  --url https://api.hubapi.com/marketing/v3/marketing-events/batch/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "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>"
        }
      ],
      "objectId": "<string>",
      "endDateTime": "2023-11-07T05:31:56Z",
      "eventCancelled": true,
      "eventDescription": "<string>",
      "eventName": "<string>",
      "eventOrganizer": "<string>",
      "eventType": "<string>",
      "eventUrl": "<string>",
      "startDateTime": "2023-11-07T05:31:56Z"
    }
  ]
}
'

{
  "completedAt": "2023-11-07T05:31:56Z",
  "results": [
    {
      "createdAt": "2023-11-07T05:31:56Z",
      "customProperties": [
        {
          "name": "<string>",
          "value": "<string>"
        }
      ],
      "eventName": "<string>",
      "objectId": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z",
      "appInfo": {
        "id": "<string>",
        "name": "<string>"
      },
      "endDateTime": "2023-11-07T05:31:56Z",
      "eventCancelled": true,
      "eventCompleted": true,
      "eventDescription": "<string>",
      "eventOrganizer": "<string>",
      "eventType": "<string>",
      "eventUrl": "<string>",
      "startDateTime": "2023-11-07T05:31:56Z"
    }
  ],
  "startedAt": "2023-11-07T05:31:56Z",
  "status": "CANCELED",
  "links": {},
  "requestedAt": "2023-11-07T05:31:56Z"
}

Produtos suportados

Requer um dos seguintes produtos ou superior.

Marketing Hub -Grátis

Sales Hub -Grátis

Service Hub -Grátis

Content Hub -Grátis

Escopos Necessários

Authorizations

Authorization

string

header

required

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

Body

application/json

inputs

object[]

required

Mostrar atributos filhos

inputs.customProperties

object[]

required

Mostrar atributos filhos

inputs.customProperties.dataSensitivity

enum<string>

required

Nível de sensibilidade dos dados

Opções disponíveis:

high,

none,

standard

inputs.customProperties.isEncrypted

boolean

required

Indica se a propriedade está criptografada

inputs.customProperties.isLargeValue

boolean

required

Indica se o valor da propriedade está armazenado como um valor grande no armazenamento

inputs.customProperties.name

string

required

Nome da propriedade personalizada

inputs.customProperties.persistenceTimestamp

integer<int64>

required

O registro de data e a hora que indica quando o valor que está sendo gravado é persistido no armazenamento

inputs.customProperties.requestId

string

required

O ID da solicitação

inputs.customProperties.selectedByUser

boolean

required

Indica se a propriedade está selecionada

inputs.customProperties.selectedByUserTimestamp

integer<int64>

required

A data e a hora em que a propriedade foi selecionada pelo usuário

inputs.customProperties.source

enum<string>

required

Origem da propriedade

Opções disponíveis:

ACADEMY,

ACCEPTANCE_TEST,

ACTIVITY_AUTO_ASSOCIATE,

ADS,

AI_GROUP,

ANALYTICS,

API,

APPROVALS,

ASSISTS,

ASSOCIATIONS,

AUTO_ASSOCIATE_BY_DOMAIN,

AUTOMATION_JOURNEY,

AUTOMATION_PLATFORM,

AVATARS_SERVICE,

BATCH_UPDATE,

BCC_TO_CRM,

BEHAVIORAL_EVENTS,

BET_ASSIGNMENT,

BET_CRM_CONNECTOR,

BIDEN,

BILLING,

BOT,

CALCULATED,

CENTRAL_EXCHANGE_RATES,

CHATSPOT,

CLONE_OBJECTS,

COMMUNICATOR,

COMPANIES,

COMPANY_FAMILIES,

COMPANY_INSIGHTS,

CONTACTS,

CONTACTS_WEB,

CONTENT_MEMBERSHIP,

CONVERSATIONAL_ENRICHMENT,

CONVERSATIONS,

CRM_PROCESSES_PLATFORM,

CRM_UI,

CRM_UI_BULK_ACTION,

CUSTOMER_AGENT,

DATA_ENRICHMENT,

DATASET,

DEALS,

DEFAULT,

DELETE_OBJECTS,

EMAIL,

EMAIL_INBOX_IMPORT,

EMAIL_INTEGRATION,

ENGAGEMENTS,

EXTENSION,

FILE_MANAGER,

FLYWHEEL_PRODUCT_DATA_SYNC,

FORECASTING,

FORM,

FORWARD_TO_CRM,

GMAIL_INTEGRATION,

GOALS,

HEISENBERG,

HELP_DESK,

HELP_DESK_AI,

IMPORT,

INTEGRATION,

INTEGRATIONS_PLATFORM,

INTEGRATIONS_SYNC,

INTENT,

INTERNAL_PROCESSING,

LEADIN,

LEGAL_BASIS_REMEDIATION,

MARKET_SOURCING,

MARKETPLACE,

MEETINGS,

MERGE_COMPANIES,

MERGE_CONTACTS,

MERGE_OBJECTS,

MERGE_REVERT_OBJECTS,

MICROAPPS,

MIGRATION,

MOBILE_ANDROID,

MOBILE_IOS,

PAYMENTS,

PIPELINE_SETTINGS,

PLAYBOOKS,

PORTAL_OBJECT_SYNC,

PORTAL_USER_ASSOCIATOR,

PRESENTATIONS,

PRIMARY_AUTOMATION,

PROPERTY_DEFAULT_VALUE,

PROPERTY_RESTORE,

PROPERTY_SETTINGS,

PROSPECTING_AGENT,

QUOTAS,

QUOTES,

RECYCLING_BIN,

RESTORE_OBJECTS,

SALES,

SALES_MESSAGES,

SALESFORCE,

SEQUENCES,

SETTINGS,

SIDEKICK,

SIGNALS,

SLACK_INTEGRATION,

SOCIAL,

SUCCESS,

TALLY,

TASK,

UNKNOWN,

WAL_INCREMENTAL,

WORK_UI,

WORKFLOW_CONTACT_DELETE_ACTION,

WORKFLOWS

inputs.customProperties.sourceId

string

required

Identificação da origem da propriedade

inputs.customProperties.sourceLabel

string

required

Rótulo da origem da propriedade

inputs.customProperties.sourceMetadata

string

required

Metadados de origem codificados como uma string base64

inputs.customProperties.sourceUpstreamDeployable

string

required

Indica qual serviço upstream fez a alteração da propriedade

inputs.customProperties.sourceVid

integer<int64>[]

required

The unique identifier associated with the source.

inputs.customProperties.timestamp

integer<int64>

required

A data e hora da solicitação

inputs.customProperties.unit

string

required

A unidade

inputs.customProperties.updatedByUserId

integer<int32>

required

O ID do usuário que atualizou a propriedade pela última vez

inputs.customProperties.useTimestampAsPersistenceTimestamp

boolean

required

Indica se a data/hora de persistência é a mesma que a data/hora da versão de armazenamento

inputs.customProperties.value

string

required

Valor da propriedade personalizada

inputs.objectId

string

required

O ID interno do evento de marketing no HubSpot

inputs.endDateTime

string<date-time>

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

inputs.eventCancelled

boolean

Indica se o evento de marketing foi cancelado

inputs.eventDescription

string

A descrição do evento de marketing.

inputs.eventName

string

O nome do evento de marketing

inputs.eventOrganizer

string

O nome do organizador do evento de marketing

inputs.eventType

string

O tipo de evento de marketing

inputs.eventUrl

string

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

inputs.startDateTime

string<date-time>

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

Response

successful operation

completedAt

string<date-time>

required

A data e a hora quando a solicitação foi processada.

results

object[]

required

Mostrar atributos filhos

results.createdAt

string<date-time>

required

A data e a hora de criação do evento de marketing

results.customProperties

object[]

required

Mostrar atributos filhos

results.customProperties.name

string

required

O nome da propriedade no CRM

results.customProperties.value

string

required

O valor da propriedade no CRM

results.eventName

string

required

O nome do evento de marketing

results.objectId

string

required

O ID interno do evento de marketing no HubSpot

results.updatedAt

string<date-time>

required

A data e a hora de atualização do evento de marketing

results.appInfo

object

Mostrar atributos filhos

results.appInfo.id

string

required

O ID do aplicativo

results.appInfo.name

string

required

O nome do aplicativo

results.endDateTime

string<date-time>

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

results.eventCancelled

boolean

Indica se o evento de marketing foi cancelado

results.eventCompleted

boolean

Indica se o evento de marketing foi concluído

results.eventDescription

string

A descrição do evento de marketing.

results.eventOrganizer

string

O nome do organizador do evento de marketing

results.eventType

string

O tipo de evento de marketing

results.eventUrl

string

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

results.startDateTime

string<date-time>

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

startedAt

string<date-time>

required

A data e a hora do início do processamento da solicitação.

status

enum<string>

required

O status da resposta.

Opções disponíveis:

CANCELED,

COMPLETE,

PENDING,

PROCESSING

links

object

O objeto de resultado da solicitação.

Mostrar atributos filhos

links.{key}

string

requestedAt

string<date-time>

A data e a hora do envio da solicitação.

Last modified on December 10, 2025

Criar ou atualizar vários eventos de marketing

Excluir vários eventos de marketing por ObjectId

⌘I

E-mail transacional

Preferências de assinatura v3

Preferências de assinatura v4

E-mails de marketing

Eventos de marketing

Envio único

Campanhas

Formulários

Reuniões

Atualizar vários eventos de marketing por ObjectId

Authorizations

Body

Response