Zum Hauptinhalt springen
POST
/
communication-preferences
/
2026-03
/
links
/
generate
Abonnement-Links generieren
curl --request POST \
  --url https://api.hubapi.com/communication-preferences/2026-03/links/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "subscriberIdString": "<string>",
  "language": "<string>",
  "subscriptionId": 123
}
'
{
  "managePreferencesUrl": "<string>",
  "subscriberIdString": "<string>",
  "unsubscribeAllUrl": "<string>",
  "unsubscribeSingleUrl": "<string>"
}

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, für den die Links generiert werden. Muss „EMAIL“ sein.

Verfügbare Optionen:
EMAIL
businessUnitId
integer<int64>
Standard:0

Die ID des Unternehmensbereichs, die mit der Anfrage verknüpft ist. Standardmäßig 0.

Body

application/json
subscriberIdString
string
erforderlich

Eine Zeichenfolge, die die eindeutige ID des Abonnenten darstellt. Diese Eigenschaft ist erforderlich.

language
string

Die Sprache, in der der generierte Link angezeigt werden soll, als Zeichenfolge dargestellt.

subscriptionId
integer<int64>

Die eindeutige ID für das Abonnement, dargestellt als Ganzzahl im int64-Format.

Antwort

successful operation

managePreferencesUrl
string
erforderlich

Die URL, unter der der Abonnent seine Kommunikationspräferenzen verwalten kann.

subscriberIdString
string
erforderlich

Eine Zeichenfolge, die die eindeutige ID des Abonnenten darstellt.

unsubscribeAllUrl
string
erforderlich

Eine Zeichenfolge, die die URL zum Abmelden von jeglicher Kommunikation für den Abonnenten enthält.

unsubscribeSingleUrl
string

Eine Zeichenfolge, die die URL zum Abmelden von einer einzelnen Kommunikation enthält.

Last modified on April 13, 2026