Bounces & Complaints
Sachez quels e-mails ne sont pas arrivés, et pourquoi
Hard et soft bounces, blocages, plaintes pour spam et signalements d'abus dans un seul flux. Interrogez-le avec un cursor, nettoyez vos listes et ne manquez jamais un événement.
- Commandes JSON
- Polling par cursor
- Jusqu'à 1000 par appel
- 90 derniers jours
- Lecture seule
https://g.sendcorex.com/v1/feedbackfeedback:readFonctionnement
Tout ce qui est revenu
Les bounces à l'envoi, les messages de bounce qui arrivent plus tard, les feedback loops de Microsoft et Yahoo, et les signalements d'abus qu'on nous envoie. Un flux, une structure.
Hard, soft ou bloqué
Tous les 5xx ne signifient pas une mauvaise adresse. Chaque événement indique si l'adresse n'existe plus (hard), si c'était temporaire (soft) ou si le message lui-même a été refusé (blocked).
Conçu pour le polling
Du plus ancien au plus récent, avec un cursor toujours renvoyé. Conservez-le, renvoyez-le, et vous obtenez exactement ce qui est nouveau. Un événement par e-mail, jamais deux fois.
Premiers pas
Seule la key est nécessaire avant votre première requête.
- 1
Créez une API key avec feedback:read
Dans le dashboard, ouvrez Developers → API Keys et créez une key avec le scope feedback:read, ou ajoutez-le à une key que vous utilisez déjà.
Le token du webmail ne fonctionne pas ici. Cette API utilise l'API key du dashboard.
- 2
Interrogez le flux
List Feedback renvoie ce qui est nouveau depuis votre cursor. Conservez le next_cursor qu'il vous donne et envoyez-le au prochain appel.
- 3
Consultez un e-mail
Get Email vous donne tout ce qui est revenu pour un id d'e-mail : son bounce, sa plainte ou la raison pour laquelle il n'a pas été envoyé.
L'événement
Les deux commandes renvoient les événements sous cette forme.
{
"email_id": "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30",
"kind": "bounce_hard",
"source": "smtp",
"recipient": "old.address@gmail.com",
"from": "noreply@yourdomain.com",
"smtp_code": 550,
"enhanced_code": "5.1.1",
"diagnostic": "550-5.1.1 The email account that you tried to reach does not exist.",
"at": "2026-10-17T05:58:44.031Z"
}kindbounce_hard, bounce_soft, blocked, complaint ou dropped. Seuls les hard bounces et les plaintes signifient « arrêtez d'envoyer à cette adresse ».
sourceD'où il vient : la réponse SMTP, un message de bounce ultérieur, un feedback loop ou un signalement d'abus.
smtp_code / enhanced_codeLe code renvoyé par le serveur, comme 550 et 5.1.1. diagnostic contient le texte complet.
email_idLe même id que dans Logs et dans les webhooks, pour pouvoir les relier.
Votre première requête
Vos hard bounces et plaintes depuis le début du mois. Remplacez SENDCOREX_API_KEY par votre API key.
curl -X POST 'https://g.sendcorex.com/v1/feedback' \
-H "Authorization: $SENDCOREX_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"commands": [
{ "command": "list_feedback", "args": { "since": "2026-10-01T00:00:00Z", "kinds": ["bounce_hard", "complaint"] } }
]
}'Vous obtenez les événements du plus ancien au plus récent et un next_cursor. Conservez-le et envoyez-le au prochain appel pour n'obtenir que ce qui est nouveau. La même requête en 8 langages se trouve dans List Feedback.
Cas d'usage courants
Gardez vos listes propres
Interrogez toutes les 30 secondes et retirez les adresses en hard bounce ou en plainte. Votre réputation reste élevée et vos envois restent hors du spam.
PollingRepérez vite les plaintes
Filtrez le flux sur complaint et alertez votre équipe : un pic de plaintes est le premier signe qu'une campagne tourne mal.
Filtrer par typeExpliquez un e-mail manquant
À partir d'un id d'e-mail, montrez à votre client la raison exacte donnée par le serveur destinataire.
Get EmailRecevez-les en push
Les webhooks bounced et fbl_complaint envoient les mêmes événements au moment où ils se produisent. Utilisez le polling comme filet de sécurité.
WebhooksRéférence complète
Tout ce qui est marqué CMD est une commande envoyée via POST /v1/feedback, jusqu'à 20 par requête.