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.
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.
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
eventValor fijo: "return_path".
timestampCuándo se procesó el mensaje de bounce (ISO 8601, UTC).
data.recipientEmailDirección de email del destinatario.
data.fromAddressDirección de email del remitente.
data.reasonEl error del mensaje de bounce (hasta 300 caracteres).
data.trackingIdIdentificador del email original, tomado de la dirección de bounce.