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-03/events/{externalEventId}/{subscriberState}/email-upsert

Request

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

Path parameters

externalEventIdstring required
subscriberStatestring required

Query parameters

externalAccountIdstring required

Request body

Response

An error occurred.

categorystring required

The error category

contextobject

Context about the error condition

correlationIdstring uuid required

A unique identifier for the request. Include this value with any error reports or support tickets

linksobject

A map of link names to associated URIs containing documentation about the error or recommended remediation steps

messagestring required

A human readable message describing the error along with remediation steps where appropriate

subCategorystring

A specific category that contains more specific detail about the error

Example response

{
  "category": "VALIDATION_ERROR",
  "correlationId": "aeb5f871-7f07-4993-9211-075dc63e7cbf",
  "links": {
    "knowledge-base": "https://www.hubspot.com/products/service/knowledge-base"
  },
  "message": "Invalid input (details will vary based on the error)"
}

Changes

  • b0d8bc008db9Revision changes
    • info

      api operation id post-/marketing/marketing-events/2026-03/events/{externalEventId}/{subscriberState}/email-upsert_upsertByContactEmail removed and replaced with post-/marketing/marketing-events/2026-03/events/{externalEventId}/{subscriberState}/email-upsert

  • 62586336cea2Revision changes
    • info

      endpoint added

Some revisions have not been checked yet.