HUhubspot
Basic

Create or update a marketing event

Changed on

Upserts a marketing event If there is an existing marketing event with the specified ID, it will be updated; otherwise a new event will be created.

put/marketing/marketing-events/2026-09/events/{externalEventId}

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/marketing/marketing-events/2026-09/events/{externalEventId}
  • 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

Path parameters

externalEventIdstring required

The id of the marketing event in the external event application.

Request body

endDateTimestring date-time

The end date and time of the marketing event.

eventCancelledboolean

Indicates if the marketing event has been cancelled. Defaults to false

eventCompletedboolean

Indicates if the marketing event has been completed. Defaults to false

eventDescriptionstring

The description of the marketing event.

eventNamestring required

The name of the marketing event.

eventOrganizerstring required

The name of the organizer of the marketing event.

eventTypestring

Describes what type of event this is. For example: WEBINAR, CONFERENCE, WORKSHOP

eventUrlstring

A URL in the external event application where the marketing event can be managed.

externalAccountIdstring required

The accountId that is associated with this marketing event in the external event application.

externalEventIdstring required

The id of the marketing event in the external event application.

startDateTimestring date-time

The start date and time of the marketing event.

Response

successful operation

createdAtstring date-time required

The creation date and time of the marketing event.

endDateTimestring date-time

The end date and time of the marketing event.

eventCancelledboolean

Indicates if the marketing event has been cancelled.

eventCompletedboolean

Indicates if the marketing event has been completed.

eventDescriptionstring

The description of the marketing event.

eventNamestring required

The name of the marketing event.

eventOrganizerstring required

The name of the organizer of the marketing event.

eventTypestring

The type of the marketing event.

eventUrlstring

A URL in the external event application where the marketing event can be managed.

idstring required

The ID of the marketing event CRM object.

objectIdstring

The ID of the marketing event CRM object.

startDateTimestring date-time

The start date and time of the marketing event.

updatedAtstring date-time required

The update date and time of the marketing event.

Changes

  • 2026-093afcf69ad1b4Revision changes
    • breaking

      added the new required request property /////

    • info

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

  • 2026-09e62ad9a49a20Revision changes
    • 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