Status des E-Mail-Abos ändern
Verwenden Sie diesen Endpunkt, um den globalen Status des E-Mail-Abos für Ihre Nutzer:innen festzulegen.
Nutzer:innen können opted_in, unsubscribed oder subscribed sein (ohne spezielles Opt-in oder Opt-out).
Dieser Endpunkt aktualisiert den globalen E-Mail-Abo-Status der/des Nutzer:in, der sich vom Abo-Gruppenstatus unterscheidet. Der globale Abo-Status gilt für alle E-Mails, während Abo-Gruppen eine detailliertere Steuerung für bestimmte E-Mail-Typen ermöglichen. Wenn eine/ein Nutzer:in global abgemeldet ist, erhält sie/er unabhängig vom Abo-Gruppenstatus keine E-Mails. Um den Abo-Gruppenstatus abzufragen, verwenden Sie den Endpunkt Abo-Gruppenstatus von Nutzer:innen auflisten.
Sie können den Status des E-Mail-Abos für eine E-Mail-Adresse festlegen, die noch keiner Ihrer Nutzer:innen in Braze zugeordnet ist. Wenn diese E-Mail-Adresse anschließend mit einer/einem Nutzer:in verknüpft wird, wird der von Ihnen hochgeladene Status des E-Mail-Abos automatisch übernommen.
Voraussetzungen
Um diesen Endpunkt zu verwenden, benötigen Sie einen API-Schlüssel mit der Berechtigung email.status.
Rate-Limit
Wir wenden auf diesen Endpunkt das standardmäßige Braze-Rate-Limit von 250.000 Anfragen pro Stunde an, wie in API-Rate-Limits dokumentiert.
Anfragetext
1
2
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
1
2
3
4
{
"email": "[email protected]",
"subscription_state": "subscribed"
}
Anfrageparameter
| Parameter | Erforderlich | Datentyp | Beschreibung |
|---|---|---|---|
email |
Erforderlich | String oder Array | Zu ändernde String-E-Mail-Adresse oder ein Array mit bis zu 50 zu ändernden E-Mail-Adressen. |
subscription_state |
Erforderlich | String | Entweder „subscribed“, „unsubscribed“ oder „opted_in“. |
Fehlerbehebung bei SendGrid-E-Mail-Blockierungen
Wenn SendGrid eine/n Empfänger:in blockiert, aktualisieren Sie den Abo-Status mit diesem Endpunkt und überprüfen Sie das Engagement mithilfe von Segment-Filtern. Verwenden Sie Soft-Bounce-Ereignisse von Currents zur Überwachung der Zustellbarkeit und bestätigen Sie den Abo-Status, bevor Sie den Versand erneut versuchen.
Beispielanfrage
1
2
3
4
5
6
7
curl --location --request POST 'https://rest.iad-01.braze.com/email/status' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-API-KEY-HERE' \
--data-raw '{
"email": "[email protected]",
"subscription_state": "subscribed"
}'