Evento de webhook · Entrega

bounced

Enviado quando um email é rejeitado de vez: o endereço não existe, o domínio não pode receber emails ou paramos de tentar.

i

Enviado como um POST assinado para a sua URL de webhook. Veja Configuração e eventos para saber como verificar a assinatura.

Payload

// Rejected by the receiving server
{
  "event": "bounced",
  "emailId": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "timestamp": "2026-10-23T04:32:10.000Z",
  "data": {
    "recipientEmail": "invalid@domain.com",
    "fromAddress": "hello@yourdomain.com",
    "reason": "550 5.1.1 The email account that you tried to reach does not exist"
  }
}
!

Hard bounces conhecidos. Um endereço que deu hard bounce nos últimos 90 dias não é contatado de novo, e você recebe este evento com um reason que começa com "Suppressed —". Com o Hard Bounce Shield, o email é registrado como Suppressed e não conta como bounce. Você recebe este evento mesmo assim, com data.suppressed: true, para que todo email enfileirado termine com um evento final.

i

O endereço existe agora? Envie esse email com ignoreHardBounce: true e ele sai normalmente.

Opções de entrega →

Referência dos campos

  • event

    Valor fixo: "bounced".

  • emailId

    ID do email, o mesmo retornado pelo POST /send.

  • timestamp

    Quando o evento aconteceu (ISO 8601, UTC).

  • data.recipientEmail

    Endereço de email do destinatário.

  • data.fromAddress

    Endereço de email do remetente.

  • data.reason

    A resposta do servidor de destino. Começa com "Suppressed —" quando não enviamos porque o endereço deu hard bounce nos últimos 90 dias.

  • data.suppressed

    Só aparece, como true, quando o Hard Bounce Shield barrou o email. Nenhuma entrega foi tentada e não conta como bounce. Deixe fora da sua taxa de bounce.