Zum Hauptinhalt springen
POST
Upsert für ein Abonnement durchführen

Supported products

Autorisierungen

Authorization
string
header
erforderlich

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

Body

application/json
actions
enum<string>[]
erforderlich

Ein Array von Zeichenfolgen, das die Aktionen angibt, die das Abonnement auslösen. Gültige Aktionen sind „CREATE“, „UPDATE“, „DELETE“, „MERGE“, „RESTORE“.

Verfügbare Optionen:
CREATE,
UPDATE,
DELETE,
MERGE,
RESTORE,
ASSOCIATION_ADDED,
ASSOCIATION_REMOVED,
SNAPSHOT,
APP_INSTALL,
APP_UNINSTALL,
ADDED_TO_LIST,
REMOVED_FROM_LIST,
GDPR_DELETE
objectIds
integer<int64>[]
erforderlich

Ein Array von Ganzzahlen, das die IDs der an dem Abonnement beteiligten Objekte darstellt. Leer bedeutet, dass alle Objekt-IDs überwacht werden.

objectTypeId
string
erforderlich

Eine Zeichenfolge, die den Objekttyp identifiziert, für den das Abonnement erstellt oder aktualisiert wird. Zum Beispiel „0–1“ für Kontakte.

portalId
integer<int64>
erforderlich

Eine Ganzzahl, die die Portal-ID darstellt, die dem Abonnement zugeordnet ist.

properties
string[]
erforderlich

Ein Array von Zeichenfolgen, das die für das Abonnement relevanten Eigenschaften der Objekte auflistet. Eine leere Liste bedeutet, dass alle Eigenschaften überwacht werden.

subscriptionType
enum<string>
Standard:OBJECT
erforderlich

Eine Zeichenfolge, die den Abonnementtyp angibt. Der Standard- und einzig gültige Wert ist „OBJECT“.

Verfügbare Optionen:
OBJECT

Antwort

successful operation

actions
enum<string>[]
erforderlich

Eine Liste von Aktionen, die das Abonnement auslösen. Mögliche Werte sind „CREATE“, „UPDATE“, „DELETE“, „MERGE“, „RESTORE“, „ASSOCIATION_ADDED“, „ASSOCIATION_REMOVED“, „SNAPSHOT“, „APP_INSTALL“, „APP_UNINSTALL“, „ADDED_TO_LIST“, „REMOVED_FROM_LIST“ und „GDPR_DELETE“.

Verfügbare Optionen:
CREATE,
UPDATE,
DELETE,
MERGE,
RESTORE,
ASSOCIATION_ADDED,
ASSOCIATION_REMOVED,
SNAPSHOT,
APP_INSTALL,
APP_UNINSTALL,
ADDED_TO_LIST,
REMOVED_FROM_LIST,
GDPR_DELETE
appId
integer<int64>
erforderlich

Die eindeutige ID für die App, die dem Abonnement zugeordnet ist. Es handelt sich um eine Ganzzahl im int64-Format.

createdAt
string<date-time>
erforderlich

Der Zeitpunkt (Datum und Uhrzeit), zu dem das Abonnement im ISO-8601-Format erstellt wurde.

id
integer<int64>
erforderlich

Die eindeutige ID für das Abonnement. Es handelt sich um eine Ganzzahl im int64-Format.

objectTypeId
string
erforderlich

Die ID für den Objekttyp, der mit dem Abonnement verknüpft ist. Es handelt sich um eine Zeichenfolge.

subscriptionType
enum<string>
erforderlich

Der Abonnementtyp. Folgende Typen sind zulässig: „OBJECT“, „ASSOCIATION“, „EVENT“, „APP_LIFECYCLE_EVENT“, „LIST_MEMBERSHIP“ oder „GDPR_PRIVACY_DELETION“.

Verfügbare Optionen:
APP_LIFECYCLE_EVENT,
ASSOCIATION,
EVENT,
GDPR_PRIVACY_DELETION,
LIST_MEMBERSHIP,
OBJECT
updatedAt
string<date-time>
erforderlich

Der Zeitpunkt (Datum und Uhrzeit), zu dem das Abonnement im ISO-8601-Format zuletzt aktualisiert wurde.

actionOverrides
object

Ein Objekt, das Aktionsüberschreibungen enthält, wobei jeder Schlüssel eine Aktion und der Wert ein ActionOverrideRequest-Objekt ist.

associatedObjectTypeIds
string[]

Eine Liste der IDs der zugeordneten Objekttypen. Jede ID ist eine Zeichenfolge.

createdBy
integer<int64>

Die ID des Benutzers, der das Abonnement erstellt hat. Es handelt sich um eine Ganzzahl im int64-Format.

deletedAt
string<date-time>

Der Zeitpunkt (Datum und Uhrzeit), zu dem das Abonnement im ISO-8601-Format gelöscht wurde, falls zutreffend.

listIds
integer<int64>[]

Eine Liste der Listen-IDs, die dem Abonnement zugeordnet sind. Jede ID ist eine Ganzzahl im int64-Format.

objectIds
integer<int64>[]

Eine Liste der Objekt-IDs, die dem Abonnement zugeordnet sind. Jede ID ist eine Ganzzahl im int64-Format.

portalId
integer<int64>

Die eindeutige ID für das Portal, das mit dem Abonnement verknüpft ist. Es handelt sich um eine Ganzzahl im int64-Format.

properties
string[]

Eine Liste der Eigenschaftsnamen, die dem Abonnement zugeordnet sind. Jede Eigenschaft ist eine Zeichenfolge.

Zuletzt geändert am 1. April 2026