---
title: "POST /communication-preferences/2026-09/subscribe"
method: POST
path: "/communication-preferences/2026-09/subscribe"
tags: ["Advanced"]
---

# POST /communication-preferences/2026-09/subscribe

`POST /communication-preferences/2026-09/subscribe`

## Request body

- PublicUpdateSubscriptionStatusRequest
  - `emailAddress` string, required
  - `legalBasis` 'CONSENT_WITH_NOTICE' | 'LEGITIMATE_INTEREST_CLIENT' | 'LEGITIMATE_INTEREST_OTHER' | 'LEGITIMATE_INTEREST_PQL' | 'NON_GDPR' | 'PERFORMANCE_OF_CONTRACT' | 'PROCESS_AND_STORE'
  - `legalBasisExplanation` string
  - `subscriptionId` string, required

## Response `200`

successful operation

- PublicSubscriptionStatus
  - `brandId` integer
  - `description` string, required
  - `id` string, required
  - `legalBasis` 'CONSENT_WITH_NOTICE' | 'LEGITIMATE_INTEREST_CLIENT' | 'LEGITIMATE_INTEREST_OTHER' | 'LEGITIMATE_INTEREST_PQL' | 'NON_GDPR' | 'PERFORMANCE_OF_CONTRACT' | 'PROCESS_AND_STORE'
  - `legalBasisExplanation` string
  - `name` string, required
  - `preferenceGroupName` string
  - `sourceOfStatus` 'BRAND_WIDE_STATUS' | 'PORTAL_WIDE_STATUS' | 'SUBSCRIPTION_STATUS', required
  - `status` 'NOT_SUBSCRIBED' | 'SUBSCRIBED', required

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/communication-preferences-subscriptions.md) · [All operations](https://skmtc.net/hubspot/apis/communication-preferences-subscriptions/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/communication-preferences-subscriptions/versions/2976a87c3435/schema)