Sign in

v14

latestOpenAPI 3.0.0raw.githubusercontent.com2026-05-279719892.3 MB
Event Attendees

Record Participants by Email with Marketing Event Object Id

Records the participation of multiple HubSpot contacts in a Marketing Event using their email addresses.

If a contact does not exist, it will be automatically created. The contactProperties field is used exclusively for creating new contacts and will not update properties of existing contacts.

Additional Functionality:

  • Adds a timeline event to the contacts.

Allowed Properties: For the state "attend":

  • joinedAt
  • leftAt
post/marketing/marketing-events/2026-03/{objectId}/attendance/{subscriberState}/email-create

Path parameters

objectIdstring required

The internal id of the marketing event in HubSpot.

subscriberStatestring required

The attendance state value. It may be 'register', 'attend' or 'cancel'

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