HUhubspot
Status

Update a contact's subscription status

Changed on

Set the subscription status of a specific contact.

post/communication-preferences/2026-09/statuses/{subscriberIdString}

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/communication-preferences/2026-09/statuses/{subscriberIdString}
  • Auth
    OAuth 2
    Authorization code: https://app.hubspot.com/oauth/authorize
    Token URL: https://api.hubapi.com/oauth/v1/token scopes: communication_preferences.read_write

Path parameters

subscriberIdStringstring required

The unique identifier of the subscriber whose communication preferences status is to be updated.

Request body

channel'EMAIL' required

The type of communication channel, with 'EMAIL' as the only supported option.

legalBasis'CONSENT_WITH_NOTICE' | 'LEGITIMATE_INTEREST_CLIENT' | 'LEGITIMATE_INTEREST_OTHER' | 'LEGITIMATE_INTEREST_PQL' | 'NON_GDPR' | 'PERFORMANCE_OF_CONTRACT' | 'PROCESS_AND_STORE'

The legal basis for communication, with options including 'LEGITIMATE_INTEREST_PQL', 'LEGITIMATE_INTEREST_CLIENT', 'PERFORMANCE_OF_CONTRACT', 'CONSENT_WITH_NOTICE', 'NON_GDPR', 'PROCESS_AND_STORE', and 'LEGITIMATE_INTEREST_OTHER'.

legalBasisExplanationstring

An explanation for the legal basis used for communication.

statusState'NOT_SPECIFIED' | 'SUBSCRIBED' | 'UNSUBSCRIBED' required

The current subscription status of the contact, which can be 'SUBSCRIBED', 'UNSUBSCRIBED', or 'NOT_SPECIFIED'.

subscriptionIdinteger required

The unique identifier of the subscription to be updated.

Response

successful operation

completedAtstring date-time required

The date and time when the operation was completed.

linksobject

Contains URLs related to the response, such as documentation or resources.

numErrorsinteger

The number of errors that occurred during the operation.

requestedAtstring date-time

The date and time when the request was made.

startedAtstring date-time required

The date and time when the operation started.

status'CANCELED' | 'COMPLETE' | 'PENDING' | 'PROCESSING' required

Indicates the current status of the operation, with possible values: PENDING, PROCESSING, CANCELED, COMPLETE.

Changes

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

    • info

      the endpoint scheme security private_apps was removed from the API

    • info

      the security scope communication_preferences.read_write was added to the endpoint's security scheme oauth2

    • info

      the security scope communication_preferences.write was removed from the endpoint's security scheme oauth2

    • info

      api tag Status added

    • info

      api tag Basic removed