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

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

bounce_hard, bounce_soft, blocked, complaint oder dropped. Nur Hard Bounces und Beschwerden bedeuten „nicht mehr an diese Adresse senden“.

source

Woher es kam: die SMTP-Antwort, eine spätere Bounce-Nachricht, ein Feedback Loop oder eine Missbrauchsmeldung.

smtp_code / enhanced_code

Der Code, den der Server geantwortet hat, etwa 550 und 5.1.1. diagnostic enthält den vollständigen Text.

email_id

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

Polling

Beschwerden 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 filtern

Eine fehlende E-Mail erklären

Zeigen Sie Ihrem Kunden anhand einer E-Mail-ID den genauen Grund, den der empfangende Server genannt hat.

Get Email

Stattdessen per Push erhalten

Die Webhooks bounced und fbl_complaint senden dieselben Ereignisse in dem Moment, in dem sie passieren. Nutzen Sie Polling als Sicherheitsnetz.

Webhooks

Vollständige Referenz

Alles mit CMD ist ein Befehl, der über POST /v1/feedback gesendet wird, bis zu 20 pro Request.