Saltar al contenido principal
GET
/
communication-preferences
/
v3
/
status
/
email
/
{emailAddress}
Obtener estados de suscripción de un contacto
curl --request GET \
  --url https://api.hubapi.com/communication-preferences/v3/status/email/{emailAddress} \
  --header 'Authorization: Bearer <token>'
{
  "recipient": "<string>",
  "subscriptionStatuses": [
    {
      "description": "<string>",
      "id": "<string>",
      "name": "<string>",
      "sourceOfStatus": "BRAND_WIDE_STATUS",
      "status": "NOT_SUBSCRIBED",
      "brandId": 123,
      "legalBasis": "CONSENT_WITH_NOTICE",
      "legalBasisExplanation": "<string>",
      "preferenceGroupName": "<string>"
    }
  ]
}

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing Hub -Enterprise
Sales HubSales Hub -Gratuito
Service HubService Hub -Gratuito
Content HubContent Hub -Gratuito

Autorizaciones

Authorization
string
header
requerido

The access token received from the authorization server in the OAuth 2.0 flow.

Parámetros de ruta

emailAddress
string
requerido

Respuesta

successful operation

recipient
string
requerido

Dirección de correo del contacto.

subscriptionStatuses
object[]
requerido

Una lista de todos los estados de las suscripciones del contacto.

Last modified on December 8, 2025