Cambiar el estado de la suscripción por correo electrónico

Utiliza este endpoint para establecer el estado global 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).

Nota

Este endpoint actualiza el estado global de suscripción de correo electrónico del usuario, que es diferente del estado del grupo de suscripción. El estado global de suscripción se aplica a todos los correos electrónicos, mientras que los grupos de suscripción permiten un control más granular sobre tipos específicos de correos electrónicos. Cuando un usuario cancela su suscripción de forma global, no recibirá correos electrónicos independientemente del estado de su grupo de suscripción. Para consultar el estado del grupo de suscripción, utiliza el endpoint Listar el estado del grupo de suscripción del usuario.

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 endpoint, 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 endpoint, 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

Solución de problemas de bloqueos de correo electrónico de SendGrid

Cuando SendGrid bloquea a un destinatario, actualiza el estado de suscripción con este endpoint y revisa la participación con filtros de segmento. Utiliza los eventos de rebote suave de Currents para monitorear la capacidad de entrega, y confirma el estado de suscripción antes de reintentar los envíos.

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"
}'