Evento de webhook · Entrega
return_path
Enviado quando uma mensagem de bounce (DSN) chega depois, após o servidor de destino ter aceitado o email. Uma falha muda o email para bounced. Um aviso de atraso ou de entrega só envia este evento.
Enviado como um POST assinado para a sua URL de webhook. Veja Configuração e eventos para saber como verificar a assinatura.
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"
}
}Sem emailId no nível principal. A mensagem de bounce só traz o nosso ID de tracking, então este evento vem sem emailId. Use data.trackingId e data.recipientEmail para fazer a correspondência.
O que acontece com o endereço. Se o endereço não existe, ele entra na lista de hard bounce por 90 dias e os envios seguintes para ele são suprimidos. Caixa cheia conta como soft bounce, e depois de 3 seguidos o endereço é tratado como hard bounce. Bloqueios por política ou reputação (5.7.x) não marcam o endereço. Um aviso de que o email atrasou ou foi entregue mantém o status do email como está.
Evento bounced →Referência dos campos
eventValor fixo: "return_path".
timestampQuando a mensagem de bounce foi processada (ISO 8601, UTC).
data.recipientEmailEndereço de email do destinatário.
data.fromAddressEndereço de email do remetente.
data.reasonO erro da mensagem de bounce (até 300 caracteres).
data.trackingIdIdentificador do email original, vindo do endereço de bounce.