Passer au contenu principal
GET
/
communication-preferences
/
2026-03
/
statuses
/
{subscriberIdString}
Obtenir la page de gestion des inscriptions pour un contact spécifique
curl --request GET \
  --url https://api.hubapi.com/communication-preferences/2026-03/statuses/{subscriberIdString} \
  --header 'Authorization: Bearer <token>'
{
  "completedAt": "2023-11-07T05:31:56Z",
  "results": [
    {
      "channel": "EMAIL",
      "source": "<string>",
      "status": "NOT_SPECIFIED",
      "subscriberIdString": "<string>",
      "subscriptionId": 123,
      "timestamp": "2023-11-07T05:31:56Z",
      "businessUnitId": 123,
      "legalBasis": "CONSENT_WITH_NOTICE",
      "legalBasisExplanation": "<string>",
      "setStatusSuccessReason": "NO_STATUS_CHANGE",
      "subscriptionName": "<string>"
    }
  ],
  "startedAt": "2023-11-07T05:31:56Z",
  "status": "CANCELED",
  "errors": [
    {
      "category": "<string>",
      "context": {},
      "errors": [
        {
          "message": "<string>",
          "code": "<string>",
          "context": "{missingScopes=[scope1, scope2]}",
          "in": "<string>",
          "subCategory": "<string>"
        }
      ],
      "links": {},
      "message": "<string>",
      "status": "<string>",
      "id": "<string>",
      "subCategory": {}
    }
  ],
  "links": {},
  "numErrors": 123,
  "requestedAt": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt

Use this file to discover all available pages before exploring further.

Supported products

Autorisations

Authorization
string
header
requis

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

Paramètres de chemin

subscriberIdString
string
requis

L'identifiant unique de l'abonné(e) dont le statut des préférences de communication est récupéré.

Paramètres de requête

channel
enum<string>
requis

Le canal de communication pour lequel le statut d'abonnement est récupéré. Ce paramètre est obligatoire et ne prend actuellement en charge que l'« EMAIL ».

Options disponibles:
EMAIL
businessUnitId
integer<int64>

L'ID de l'unité commerciale pour filtrer le statut d'abonnement. Ce paramètre est facultatif.

Réponse

successful operation

completedAt
string<date-time>
requis

La date et l'heure de la fin de l'opération.

results
object[]
requis

Une série de résultats issus de l'opération.

startedAt
string<date-time>
requis

La date et l'heure du début de l'opération.

status
enum<string>
requis

Indique l'état actuel de l'opération, avec les valeurs possibles suivantes : EN ATTENTE, EN COURS DE TRAITEMENT, ANNULÉ, TERMINÉ.

Options disponibles:
CANCELED,
COMPLETE,
PENDING,
PROCESSING
errors
object[]

Liste des erreurs survenues pendant l'opération.

Contient les URL liées à la réponse, telles que la documentation ou les ressources.

numErrors
integer<int32>

Le nombre d'erreurs survenues pendant l'opération.

requestedAt
string<date-time>

La date et l'heure auxquelles la demande a été faite.

Last modified on April 13, 2026