Evento de webhook · Entrega

failed

Se envía cuando dejamos de intentar un email porque se agotaron los reintentos.

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

// Rate-limit cycles ran out
{
  "event": "failed",
  "emailId": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "timestamp": "2026-10-23T04:32:10.000Z",
  "data": {
    "recipientEmail": "user@example.com",
    "fromAddress": "hello@yourdomain.com",
    "reason": "Max retries (4) exceeded: 421 4.7.28 Our system has detected an unusual rate of mail from your IP"
  }
}
!

También puedes recibir bounced. Cuando los errores temporales, los fallos de conexión o el greylisting agotan los reintentos, el email también se registra como bounce y se envía un evento bounced. Cuando se agotan los ciclos de rate limit, solo se envía failed.

i

Controla cuánto tiempo seguimos intentándolo. Define retryRateLimited, retryUnavailable y retryUnavailableSeconds por email.

Opciones de entrega →

Referencia de campos

  • event

    Valor fijo: "failed".

  • 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

    Por qué dejamos de intentarlo. "Max retries (N) exceeded" significa que se agotaron los ciclos de rate limit; si no, es la última respuesta del servidor de destino.

  • data.notSent

    Solo aparece (true) cuando el correo nunca se envió por un motivo de tu cuenta: sin créditos, cuenta bloqueada o restringida, dominio del remitente en Spamhaus o sin DKIM, o From inválido. No es un rebote. El log queda con estado not_sent y data.reason trae el motivo exacto.