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.

i

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.

i

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

  • event

    Valor fixo: "return_path".

  • timestamp

    Quando a mensagem de bounce foi processada (ISO 8601, UTC).

  • data.recipientEmail

    Endereço de email do destinatário.

  • data.fromAddress

    Endereço de email do remetente.

  • data.reason

    O erro da mensagem de bounce (até 300 caracteres).

  • data.trackingId

    Identificador do email original, vindo do endereço de bounce.