Zum Hauptinhalt springen
POST
/
communication-preferences
/
v4
/
statuses
/
batch
/
unsubscribe-all
/
read
Status batchweise lesen
curl --request POST \
  --url https://api.hubapi.com/communication-preferences/v4/statuses/batch/unsubscribe-all/read \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    "<string>"
  ]
}
'
{
  "completedAt": "2023-11-07T05:31:56Z",
  "results": [
    {
      "subscriberIdString": "<string>",
      "wideStatuses": [
        {
          "subscriberIdString": "<string>",
          "timestamp": "2023-11-07T05:31:56Z",
          "businessUnitId": 123
        }
      ]
    }
  ],
  "startedAt": "2023-11-07T05:31:56Z",
  "links": {},
  "requestedAt": "2023-11-07T05:31:56Z"
}

Documentation Index

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

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

Supported products

Autorisierungen

Authorization
string
header
erforderlich

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

Abfrageparameter

channel
enum<string>
erforderlich

Der Kommunikationskanal, über den der Abmeldestatus überprüft werden soll. Dieser Parameter ist erforderlich und unterstützt derzeit nur „EMAIL“.

Verfügbare Optionen:
EMAIL
businessUnitId
integer<int64>

Die ID des Unternehmensbereichs. Dies ist ein optionaler Parameter.

Body

application/json
inputs
string[]
erforderlich

Eine Liste von Zeichenfolgen, die für die Eingaben von Batch-Vorgängen stehen.

Antwort

successful operation

completedAt
string<date-time>
erforderlich

Der Zeitpunkt (Datum und Uhrzeit), zu dem der Batch-Prozess abgeschlossen wurde.

results
object[]
erforderlich

Das Array der Ergebnisse aus dem Batch-Prozess, die jeweils Informationen zum Abonnementstatus enthalten.

startedAt
string<date-time>
erforderlich

Der Zeitpunkt (Datum und Uhrzeit), zu dem der Batch-Prozess begann.

status
enum<string>
erforderlich

Der aktuelle Status des Batch-Prozesses mit den möglichen Werten: PENDING, PROCESSING, CANCELED oder COMPLETE.

Verfügbare Optionen:
CANCELED,
COMPLETE,
PENDING,
PROCESSING

Eine Sammlung von zugehörigen Links, die der Batch-Antwort zugeordnet sind.

requestedAt
string<date-time>

Der Zeitpunkt (Datum und Uhrzeit), zu dem die Batch-Anfrage gestellt wurde.

Last modified on May 11, 2026