Cambiar el estado de la suscripción por correo electrónico
Utiliza este punto de conexión para establecer el estado de suscripción de correo electrónico para tus usuarios.
Los usuarios pueden ser opted_in, unsubscribed o subscribed (sin opción específica de inclusión o exclusión).
Puedes establecer el estado de suscripción por correo electrónico para una dirección de correo electrónico que aún no esté asociada a ninguno de tus usuarios dentro de Braze. Cuando esa dirección de correo electrónico se asocie posteriormente a un usuario, se establecerá automáticamente el estado de suscripción de correo electrónico que cargaste.
Requisitos previos
Para utilizar este punto de conexión, necesitarás una clave de API con el permiso email.status.
Límite de velocidad
Aplicamos el límite de velocidad predeterminado de Braze de 250 000 solicitudes por hora a este punto de conexión, como se documenta en Límites de velocidad de la API.
Cuerpo de la solicitud
1
2
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
1
2
3
4
{
"email": "[email protected]",
"subscription_state": "subscribed"
}
Parámetros de la solicitud
| Parámetro | Obligatorio | Tipo de datos | Descripción |
|---|---|---|---|
email |
Obligatorio | Cadena o matriz | Cadena de direcciones de correo electrónico a modificar, o una matriz de hasta 50 direcciones de correo electrónico a modificar. |
subscription_state |
Obligatorio | Cadena | “subscribed”, “unsubscribed” u “opted_in”. |
Ejemplo de solicitud
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"
}'