HUhubspot
Subscriber State Changes

Record a subscriber state by contact ID

Changed on

Record a subscriber state between multiple HubSpot contacts and a marketing event, using HubSpot contact IDs. Note that the contact must already exist in HubSpot; a contact will not be created.

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

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/marketing/marketing-events/2026-09/events/{externalEventId}/{subscriberState}/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 may include values such as 'register', 'attend', or 'cancel'.

Query parameters

externalAccountIdstring required

The account ID associated with the marketing event in the external event application.

Request body

Response

An error occurred.

Changes

  • 2026-09e62ad9a49a20Revision changes
    • info

      the endpoint scheme security private_apps was removed from the API

    • info

      the // request property format was generalized from int32 to int64