HUhubspot
Event Attendees

Record Participants by Email with Marketing Event Object Id

Changed on

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

Request

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

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

Changes

  • b0d8bc008db9Revision changes
    • info

      api operation id post-/marketing/marketing-events/2026-03/{objectId}/attendance/{subscriberState}/email-create_recordByEmail removed and replaced with post-/marketing/marketing-events/2026-03/{objectId}/attendance/{subscriberState}/email-create

  • 62586336cea2Revision changes
    • info

      endpoint added

Some revisions have not been checked yet.