HUhubspot
Subscriber State Changes

Record a subscriber state by contact email

Changed on

Record a subscriber state between multiple HubSpot contacts and a marketing event, using contact email addresses. Note that the contact must already exist in HubSpot; a contact will not be created. The contactProperties field is used only when creating a new contact. These properties will not update existing contacts.

post/marketing/marketing-events/2026-09/events/{externalEventId}/{subscriberState}/email-upsert

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/marketing/marketing-events/2026-09/events/{externalEventId}/{subscriberState}/email-upsert
  • 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 categorize subscribers based on their engagement with the event.

Query parameters

externalAccountIdstring required

The account ID associated with the marketing event in the external event application. This parameter is required.

Request body

Response

An error occurred.

Changes