Bounces & Complaints
Wissen, welche E-Mails nicht ankamen, und warum
Hard und Soft Bounces, Blockierungen, Spam-Beschwerden und Missbrauchsmeldungen in einem Feed. Fragen Sie ihn mit einem Cursor ab, bereinigen Sie Ihre Listen und verpassen Sie kein Ereignis.
- JSON-Befehle
- Cursor-Polling
- Bis zu 1000 pro Aufruf
- Letzte 90 Tage
- Nur Lesezugriff
https://g.sendcorex.com/v1/feedbackfeedback:readSo funktioniert es
Alles, was zurückkam
Bounces beim Versand, Bounce-Nachrichten, die später eintreffen, Feedback Loops von Microsoft und Yahoo und die Missbrauchsmeldungen, die uns Leute schicken. Ein Feed, eine Struktur.
Hard, soft oder blockiert
Nicht jeder 5xx ist eine schlechte Adresse. Jedes Ereignis sagt, ob die Adresse nicht mehr existiert (hard), ob es vorübergehend war (soft) oder ob die Nachricht selbst abgelehnt wurde (blocked).
Für Polling gebaut
Älteste zuerst, mit einem Cursor, der immer zurückkommt. Speichern Sie ihn, senden Sie ihn erneut, und Sie erhalten genau das Neue. Ein Ereignis pro E-Mail, nie doppelt.
Erste Schritte
Vor Ihrem ersten Request brauchen Sie nur den Key.
- 1
API key mit feedback:read erstellen
Öffnen Sie im Dashboard Developers → API Keys und erstellen Sie einen Key mit dem Scope feedback:read, oder fügen Sie ihn einem bestehenden Key hinzu.
Der Webmail-Token funktioniert hier nicht. Diese API verwendet den API key aus dem Dashboard.
- 2
Feed abfragen
List Feedback liefert, was seit Ihrem Cursor neu ist. Behalten Sie den zurückgegebenen next_cursor und senden Sie ihn beim nächsten Aufruf.
- 3
Eine E-Mail nachschlagen
Get Email zeigt alles, was für eine E-Mail-ID zurückkam: ihren Bounce, ihre Beschwerde oder warum sie nicht gesendet wurde.
Das Ereignis
Beide Befehle liefern Ereignisse in dieser Struktur.
{
"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 oder dropped. Nur Hard Bounces und Beschwerden bedeuten „nicht mehr an diese Adresse senden“.
sourceWoher es kam: die SMTP-Antwort, eine spätere Bounce-Nachricht, ein Feedback Loop oder eine Missbrauchsmeldung.
smtp_code / enhanced_codeDer Code, den der Server geantwortet hat, etwa 550 und 5.1.1. diagnostic enthält den vollständigen Text.
email_idDieselbe ID wie in Logs und in den Webhooks, damit Sie sie verknüpfen können.
Ihr erster Request
Ihre Hard Bounces und Beschwerden seit Monatsbeginn. Ersetzen Sie SENDCOREX_API_KEY durch Ihren 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"] } }
]
}'Sie erhalten die Ereignisse älteste zuerst und einen next_cursor. Speichern Sie ihn und senden Sie ihn beim nächsten Aufruf, um nur Neues zu erhalten. Derselbe Request in 8 Sprachen steht in List Feedback.
Häufige Aufgaben
Listen sauber halten
Fragen Sie alle 30 Sekunden ab und entfernen Sie Adressen mit Hard Bounce oder Beschwerde. Ihre Reputation bleibt hoch und Ihre Sendungen landen nicht im Spam.
PollingBeschwerden schnell erkennen
Filtern Sie den Feed nach complaint und alarmieren Sie Ihr Team: Ein Anstieg der Beschwerden ist das erste Zeichen, dass eine Kampagne schiefläuft.
Nach Typ filternEine fehlende E-Mail erklären
Zeigen Sie Ihrem Kunden anhand einer E-Mail-ID den genauen Grund, den der empfangende Server genannt hat.
Get EmailStattdessen per Push erhalten
Die Webhooks bounced und fbl_complaint senden dieselben Ereignisse in dem Moment, in dem sie passieren. Nutzen Sie Polling als Sicherheitsnetz.
WebhooksVollständige Referenz
Alles mit CMD ist ein Befehl, der über POST /v1/feedback gesendet wird, bis zu 20 pro Request.