HUhubspot
Event Attendees

Record Participants by Email with Marketing Event External Ids

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

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/marketing/marketing-events/2026-09/attendance/{externalEventId}/{subscriberState}/email-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, which can be used to indicate their attendance status.

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

  • 2026-09e62ad9a49a20Revision 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