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
POSThttps://g.sendcorex.com/v1/feedbackfeedback:read

Fonctionnement

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. 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. 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. 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"
}
kind

bounce_hard, bounce_soft, blocked, complaint ou dropped. Seuls les hard bounces et les plaintes signifient « arrêtez d'envoyer à cette adresse ».

source

D'où il vient : la réponse SMTP, un message de bounce ultérieur, un feedback loop ou un signalement d'abus.

smtp_code / enhanced_code

Le code renvoyé par le serveur, comme 550 et 5.1.1. diagnostic contient le texte complet.

email_id

Le 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.

Polling

Repé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 type

Expliquez un e-mail manquant

À partir d'un id d'e-mail, montrez à votre client la raison exacte donnée par le serveur destinataire.

Get Email

Recevez-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é.

Webhooks

Référence complète

Tout ce qui est marqué CMD est une commande envoyée via POST /v1/feedback, jusqu'à 20 par requête.