Status des E-Mail-Abos ändern
Verwenden Sie diesen Endpunkt, um den 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).
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"
}'