Evento de webhook · Entrega

return_path

Se envía cuando un mensaje de bounce (DSN) llega más tarde, después de que el servidor de destino aceptara el email. Un fallo pasa el email a bounced. Un aviso de retraso o de entrega solo envía este evento.

i

Se envía como un POST firmado a tu URL de webhook. Consulta Configuración y eventos para ver cómo verificar la firma.

Payload

// Bounce message received
{
  "event": "return_path",
  "timestamp": "2026-10-23T04:40:02.000Z",
  "data": {
    "recipientEmail": "john.doe@example.com",
    "fromAddress": "noreply@yourdomain.com",
    "reason": "550 5.1.1 The email account that you tried to reach does not exist",
    "trackingId": "7c4f2d9b-1a8e-4305-9b1e-6d2a0f7c3e81"
  }
}
!

Sin emailId en el nivel superior. El mensaje de bounce solo trae nuestro ID de tracking, así que este evento llega sin emailId. Usa data.trackingId y data.recipientEmail para relacionarlo.

i

Qué pasa con la dirección. Si la dirección no existe, entra en la lista de hard bounce durante 90 días y los envíos posteriores a ella se suprimen. Un buzón lleno cuenta como soft bounce, y tras 3 seguidos la dirección se trata como hard bounce. Los bloqueos por política o reputación (5.7.x) no marcan la dirección. Un aviso de que el email se retrasó o se entregó mantiene el estado del email tal como está.

Evento bounced →

Referencia de campos

  • event

    Valor fijo: "return_path".

  • timestamp

    Cuándo se procesó el mensaje de bounce (ISO 8601, UTC).

  • data.recipientEmail

    Dirección de email del destinatario.

  • data.fromAddress

    Dirección de email del remitente.

  • data.reason

    El error del mensaje de bounce (hasta 300 caracteres).

  • data.trackingId

    Identificador del email original, tomado de la dirección de bounce.