Sign in

v14

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

Record Participants by Email with Marketing Event External Ids

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/attendance/{externalEventId}/{subscriberState}/email-create

Path parameters

externalEventIdstring required
subscriberStatestring required

Query parameters

externalAccountIdstring

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