HUhubspot
Basic

Get Marketing Event by External IDs

Changed on

Returns the details of a Marketing Event with the specified externalAccountId, externalEventId, if it exists.

Only Marketing Events created by the same app making the request can be retrieved.

get/marketing/marketing-events/2026-03/events/{externalEventId}

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/marketing/marketing-events/2026-03/events/{externalEventId}
  • Auth
    • HTTP bearer
    • or API key in query parameter hapikey
    • or none

Path parameters

externalEventIdstring required

Query parameters

externalAccountIdstring required

Response

successful operation

attendeesinteger required

The number of HubSpot contacts that attended this marketing event.

cancellationsinteger required

The number of HubSpot contacts that registered for this marketing event, but later cancelled their registration.

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.

externalEventIdstring required

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

idstring required

The ID of the marketing event CRM object.

noShowsinteger required

The number of HubSpot contacts that registered for this marketing event, but did not attend. This field only had a value when the event is over.

objectIdstring

The ID of the marketing event CRM object.

registrantsinteger required

The number of HubSpot contacts that registered for this marketing event.

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

  • f9c7181056c5Revision changes
    • warning

      added the new BREEZE_AGENT 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

  • b0d8bc008db9Revision changes
    • info

      api operation id get-/marketing/marketing-events/2026-03/events/{externalEventId}_getDetails removed and replaced with get-/marketing/marketing-events/2026-03/events/{externalEventId}

Some revisions have not been checked yet.