Événement webhook · Livraison
failed
Envoyé lorsque nous abandonnons un e-mail après épuisement de ses nouvelles tentatives.
Envoyé sous forme de requête POST signée vers votre URL de webhook. Consultez Configuration et événements pour savoir comment vérifier la signature.
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"
}
}Vous pouvez aussi recevoir bounced. Lorsque les erreurs temporaires, les échecs de connexion ou le greylisting épuisent les nouvelles tentatives, l'e-mail est aussi enregistré comme bounce et un événement bounced est envoyé. Lorsque les cycles de rate limit sont épuisés, seul failed est envoyé.
Contrôlez combien de temps nous continuons à essayer. Définissez retryRateLimited, retryUnavailable et retryUnavailableSeconds par e-mail.
Options de livraison →Référence des champs
eventValeur fixe : "failed".
emailIdID de l'e-mail, le même que celui renvoyé par POST /send.
timestampDate de l'événement (ISO 8601, UTC).
data.recipientEmailAdresse e-mail du destinataire.
data.fromAddressAdresse e-mail de l'expéditeur.
data.reasonPourquoi nous avons abandonné. "Max retries (N) exceeded" signifie que les cycles de rate limit sont épuisés ; sinon, c'est la dernière réponse du serveur de destination.
data.notSentPrésent (true) uniquement quand l'e-mail n'a jamais été envoyé à cause de votre compte : plus de crédits, compte bloqué ou restreint, domaine d'expéditeur chez Spamhaus ou sans DKIM, ou From invalide. Ce n'est pas un rebond. Le log a le statut not_sent et data.reason donne la cause exacte.