Batch

Create or Update Multiple Marketing Events

Changed on

Upserts multiple Marketing Events. If a Marketing Event with the specified ID already exists, it will be updated; otherwise, a new event will be created.

Only Marketing Events originally created by the same app can be updated.

post/marketing/marketing-events/2026-09/events/upsert

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/marketing/marketing-events/2026-09/events/upsert
  • Auth
    OAuth 2
    Authorization code: https://app.hubspot.com/oauth/authorize
    Token URL: https://api.hubapi.com/oauth/v1/token scopes: crm.objects.marketing_events.write

Request body

Response

successful operation

completedAtstring date-time required

Timestamp of when the request was completed.

linksobject

Result of the request.

numErrorsinteger

The number of errors that occurred during the request.

requestedAtstring date-time

Timestamp of when the request was sent.

startedAtstring date-time required

Timestamp of when the request started processing.

status'CANCELED' | 'COMPLETE' | 'PENDING' | 'PROCESSING' required

Status of the response.

Changes

  • 2026-093afcf69ad1b4Revision changes
    • breaking

      added the new required request property ///////

    • info

      added the required property /////// to the response with the status

    • breaking

      added the new required request property ////

    • warning

      added the new BREEZE_AGENT enum value to the //// response property for the response status

    • warning

      added the new CONNECTED_ACCOUNT enum value to the //// response property for the response status

    • warning

      added the new CUSTOMER_PORTAL enum value to the //// response property for the response status

    • warning

      added the new DI_WRITE_TO_CRM enum value to the //// response property for the response status

    • warning

      added the new MARKETS enum value to the //// response property for the response status

    • warning

      added the new REVENUE_PLATFORM enum value to the //// response property for the response status

    • info

      the endpoint scheme security private_apps was removed from the API

    • info

      added the new BREEZE_AGENT enum value to the request property ////

    • info

      added the new CONNECTED_ACCOUNT enum value to the request property ////

    • info

      added the new CUSTOMER_PORTAL enum value to the request property ////

    • info

      added the new DI_WRITE_TO_CRM enum value to the request property ////

    • info

      added the new MARKETS enum value to the request property ////

    • info

      added the new REVENUE_PLATFORM enum value to the request property ////

    • info

      added the required property //// to the response with the status