Evento de webhook · Entrega

bounced

Se envía cuando un email se rechaza definitivamente: la dirección no existe, el dominio no puede recibir correo o dejamos de intentarlo.

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

// 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 conocidos. Una dirección que dio hard bounce en los últimos 90 días no se vuelve a contactar, y recibes este evento con un reason que empieza con "Suppressed —". Con el Hard Bounce Shield, el email se registra como Suppressed y no cuenta como bounce. Aun así recibes este evento, con data.suppressed: true, para que cada email encolado termine con un evento final.

i

¿La dirección ya existe? Envía ese email con ignoreHardBounce: true y saldrá con normalidad.

Opciones de entrega →

Referencia de campos

  • event

    Valor fijo: "bounced".

  • emailId

    ID del email, el mismo que devuelve POST /send.

  • timestamp

    Cuándo ocurrió el evento (ISO 8601, UTC).

  • data.recipientEmail

    Dirección de email del destinatario.

  • data.fromAddress

    Dirección de email del remitente.

  • data.reason

    La respuesta del servidor de destino. Empieza con "Suppressed —" cuando no enviamos porque la dirección dio hard bounce en los últimos 90 días.

  • data.suppressed

    Solo aparece, como true, cuando el Hard Bounce Shield detuvo el email. No se intentó ninguna entrega y no cuenta como bounce. Déjalo fuera de tu tasa de bounce.