Webhooks para e-mails enviados

Al enviar transactional e-mails, es importante saber si tus e-mails se entregaron correctamente o si se produjeron problemas.
Por eso introducimos los webhooks, que te permiten recibir notificaciones de inmediato en tu(s) aplicación(es).

Admitimos las siguientes notificaciones:

E-mail creado (Message Created)
E-mail enviado (Message Sent)
E-mail entregado (Message Delivered)
E-mail no entregado debido a un Hard Bounce (Message Hard Bounced)
E-mail no entregado debido a un Soft Bounce (Message Soft Bounced)
Queja por spam (Spam Complaint)
E-mail no entregado (Message Failed)

¿Cómo funciona?

Para empezar con los webhooks, ve a los ajustes del proyecto y haz clic en el proyecto para el que deseas activar los webhooks.
Después, ve a la Route para la que quieres activar los webhooks y haz clic en la pestaña Webhooks.

Haz clic en el botón Create webhook e introduce la URL en la que deseas recibir las notificaciones. Además, selecciona qué notificaciones quieres recibir. Con el botón Test Webhook puedes enviar inmediatamente un evento de prueba (webhook.test) a la URL indicada para comprobar que todo funciona correctamente.

Puedes crear varios webhooks para diferentes URLs y notificaciones.

Un ejemplo de un webhook para un e-mail creado (Message Created) es el siguiente:

message_created.json

          {
  "id": "54d7e8c9-1195-4ba0-9d3f-b9af92305add",
  "event": "message.created",
  "created_at": "2025-08-08T20:14:00.000Z",
  "data": {
    "message_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "from": {
      "email": "updates@lettermint.co",
      "name": "Lettermint Updates"
    },
    "to": ["user@example.com"],
    "cc": ["cc@example.com"],
    "bcc": ["bcc@example.com"],
    "reply_to": "help@lettermint.co",
    "subject": "Welcome to Lettermint"
  }
}

Recibirás una solicitud POST en la URL indicada con la carga útil JSON del evento.

Para la documentación completa de webhooks y todas las opciones, consulta nuestra documentación de webhooks.