Evento de webhook · Entrega
failed
Se envía cuando dejamos de intentar un email porque se agotaron los reintentos.
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.
Controla cuánto tiempo seguimos intentándolo. Define retryRateLimited, retryUnavailable y retryUnavailableSeconds por email.
Opciones de entrega →Referencia de campos
eventValor fijo: "failed".
emailIdID del email, el mismo que devuelve POST /send.
timestampCuándo ocurrió el evento (ISO 8601, UTC).
data.recipientEmailDirección de email del destinatario.
data.fromAddressDirección de email del remitente.
data.reasonPor 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.notSentSolo 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.