Event Attendees

Record Participants by ContactId with Marketing Event External Ids

Changed on

Records the participation of multiple HubSpot contacts in a Marketing Event using their HubSpot contact IDs.

Additional Functionality:

  • Adds a timeline event to the contacts.

Allowed Properties: For the state "attend":

  • joinedAt
  • leftAt
post/marketing/marketing-events/2026-09/attendance/{externalEventId}/{subscriberState}/create

Request

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

subscriberStatestring required

The state of the subscriber's attendance, such as 'register', 'attend', or 'cancel'.

Query parameters

externalAccountIdstring

The account ID associated with the marketing event in the external event application.

Request body

Response

successful operation

completedAtstring date-time required

Timestamp that represents when the request finished processing

linksobject

Result of the request

numErrorsinteger

The number of errors that occurred during the processing

requestedAtstring date-time

Timestamp that represents when the request was made

startedAtstring date-time required

Timestamp that represents when the request started processing

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

The status of the request processing

Changes

    • breaking

      the // response's property format changed from int32 to int64 for status

    • info

      the endpoint scheme security private_apps was removed from the API

    • info

      the // request property format was generalized from int32 to int64