Bounces

Wenn eine E-Mail nicht zugestellt werden kann, sendet der empfangende Server einen Bounce. MailLand klassifiziert Bounces, unterdrückt automatisch Adressen, die niemals E-Mails akzeptieren werden, und wiederholt transiente Fehler.

Bounce-TypenLink zum Abschnitt kopieren

Bounce-KategorienLink zum Abschnitt kopieren

Die Bounce-Aufschlüsselungs-API (GET /v1/deliverability/bounce-breakdown) gruppiert jeden Bounce nach der Klassifizierung, die der Mailserver (MTA) selbst der SMTP-Ablehnung zuweist, und bildet diese Klassifizierung dann auf Permanent, Temporär oder Blockiert ab. Die folgende Tabelle ist das vollständige, festgelegte Produktionsvokabular: alles, was der Host ausgibt und nicht in dieser Tabelle steht, wird als Unbekannt gezählt statt geraten:

Zwei weiter unten auf dieser Seite behandelte Endpunkte melden Bounces in einem eigenen Vokabular. /v1/transactional/bounces/statistics zählt hardBounces und softBounces aus derselben Entscheidung, die die Adresse unterdrückt (oder nicht), sodass ein blockierter Bounce nie als hart oder temporär zählt; byCategory fasst die obige Host-Klassifizierung gröber zusammen (invalid_recipient, bad_mailbox, bad_domain, mailbox_full, content_rejected, policy_reason, general_bounce). /v1/transactional/bounces/recent liefert als bounceCategory die Host-Klassifizierung der Nachricht selbst.

Automatische VerarbeitungLink zum Abschnitt kopieren

Permanente BouncesLink zum Abschnitt kopieren

1. Die Empfänger-E-Mail-Adresse wird sofort zur globalen Unterdrückungsliste hinzugefügt
2. Alle zukünftigen E-Mails (transaktional und Marketing) an diese Adresse werden blockiert
3. Ein message.bounced-Webhook-Ereignis wird mit bounce_type: "hard" ausgelöst (es wird kein separates suppression.added-Ereignis ausgelöst)

Temporäre BouncesLink zum Abschnitt kopieren

1. Der Nachrichtenstatus wird zu Bounced
2. Die Adresse wird für 30 Tage für Marketing-E-Mails unterdrückt (transaktionale E-Mails werden weiterhin zugestellt): bereits beim ersten temporären Bounce, nicht erst nach mehreren Versuchen. Ausnahme: Der erste MessageExpired-Bounce einer Adresse oder ihr erster Bounce wegen einer zu großen Nachricht (QuotaIssues mit dem erweiterten Code 5.3.4 oder 5.2.3) unterdrückt nichts; ein weiterer innerhalb von 30 Tagen unterdrückt wie üblich.
3. Ein message.bounced-Webhook-Ereignis wird mit bounce_type: "soft" ausgelöst. (Vorübergehende Fehler werden vom MTA selbst erneut versucht, bevor ein Bounce an MailLand gemeldet wird.)
4. Nach 30 Tagen läuft die Unterdrückung automatisch ab

Blockierte BouncesLink zum Abschnitt kopieren

1. Der Nachrichtenstatus ändert sich zu Bounced (bei einem AdminBounce zu Failed), aber die Empfängeradresse wird nicht zu einer Unterdrückungsliste hinzugefügt: ein blockierter Bounce ist eine Aussage über unseren Versand, nicht über das Postfach des Empfängers
2. Ein message.bounced-Webhook-Ereignis wird mit bounce_type: "blocked" ausgelöst (bei einem AdminBounce stattdessen ein message.failed-Ereignis mit reason: "admin_bounce")
3. Eine anhaltende Rate blockierter Bounces löst einen internen Alarm zur manuellen Prüfung aus; es gibt keine automatische Versandpause

Bounce-StatistikenLink zum Abschnitt kopieren

Rufen Sie aggregierte Bounce-Statistiken für einen Zeitraum ab:

GET https://api.mail.land/v1/transactional/bounces/statistics

Authentifizierung mit Authorization: Bearer <token> oder X-API-Key: <api key>.

curl https://api.mail.land/v1/transactional/bounces/statistics \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "totalBounces": 1125,
  "hardBounces": 450,
  "softBounces": 385,
  "generalBounces": 290,
  "byCategory": {
    "invalid_recipient": 380,
    "mailbox_full": 345,
    "content_rejected": 185,
    "policy_reason": 95,
    "bad_domain": 70,
    "general_bounce": 50
  }
}

Aktuelle BouncesLink zum Abschnitt kopieren

Rufen Sie die zuletzt zurückgeworfenen Nachrichten ab:

GET https://api.mail.land/v1/transactional/bounces/recent?limit=50

curl "https://api.mail.land/v1/transactional/bounces/recent?limit=50" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

[
  {
    "messageId": "t_a1b2c3d4e5f6",
    "recipientEmail": "[email protected]",
    "subject": "Your order has shipped",
    "bounceCategory": "InvalidRecipient",
    "bounceReason": "550 5.1.1 The email account does not exist",
    "bouncedAt": "2026-02-17T12:34:56Z",
    "retryCount": 0
  },
  {
    "messageId": "t_d4e5f6a1b2c3",
    "recipientEmail": "[email protected]",
    "subject": "Invoice #1234",
    "bounceCategory": "QuotaIssues",
    "bounceReason": "552 5.2.2 Mailbox full",
    "bouncedAt": "2026-02-17T11:00:00Z",
    "retryCount": 2
  }
]

Ergebnisse sind absteigend nach bouncedAt sortiert und auf die letzten 90 Tage begrenzt. bouncedAt ist der Erstellungszeitpunkt der Nachricht, kein separat erfasster Bounce-Zeitstempel.

Bounce-Nachricht erneut versuchenLink zum Abschnitt kopieren

Versuchen Sie die Zustellung einer zurückgeworfenen Nachricht manuell erneut:

POST https://api.mail.land/v1/transactional/bounces/{messageId}/retry

curl -X POST https://api.mail.land/v1/transactional/bounces/t_a1b2c3d4e5f6/retry \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Der erneute Versuch sendet den ursprünglichen Inhalt erneut über das Outbox-System von MailLand. Öffnungs- und Klick-Tracking sind bei erneut versendeten Kopien AUS: die Tracking-Wahl des ursprünglichen Versands lässt sich aus dem Nachrichtendatensatz nicht wiederherstellen.

Bounce-Rate-SchwellenwerteLink zum Abschnitt kopieren

Die Schwellenwerte sind Plan-Standardwerte und werden erst ausgewertet, sobald mindestens die Mindeststichprobengröße an Versendungen im Auswertungsfenster erreicht ist:

Der Versand wird pausiert (API-429), sobald der Pausenschwellenwert erreicht ist; dies senkt außerdem Ihren Absender-Score.

Deliverability-SperrenLink zum Abschnitt kopieren

Eine Überschreitung des Pausenschwellenwerts setzt zusätzlich eine dauerhafte Deliverability-Sperre für den Workspace, getrennt von der vorübergehenden 429-Pause oben. Solange die Sperre aktiv ist, wird jeder Versand, transaktional und Marketing gleichermaßen, abgelehnt: 403 ACTION_REQUIRED von der API, ein vorübergehendes 451 4.7.0 über SMTP-Relay, sodass Ihr Mailserver die Nachricht in der Warteschlange behält und es erneut versucht.

• Die Sperre wird einmal pro Überschreitungsvorfall gesetzt, nicht bei jedem Versand erneut.
• Sie bleibt bestehen, bis der MailLand-Support sie prüft und aufhebt; eine sich erholende Bounce- oder Beschwerderate hebt sie nicht automatisch auf, es gibt keine automatische Aufhebung.
• Die Owner und Admins des Workspace erhalten sofort nach dem Setzen der Sperre eine E-Mail.

Bewährte MethodenLink zum Abschnitt kopieren

• Bereinigen Sie Ihre Listen: validieren Sie E-Mail-Adressen vor dem Versand mit der E-Mail-Validierung. Entfernen Sie Adressen, die konsequent bouncen.
• Überwachen Sie Bounce-Kategorien: ein Anstieg bei content_rejected-Bounces kann auf ein Inhaltsproblem hinweisen, nicht auf ein Listenqualitätsproblem.
• Versuchen Sie permanente Bounces nicht erneut: permanente Bounces sind endgültig. Erneute Versuche verschwenden Kontingent und schaden der Reputation.
• Beobachten Sie Muster bei temporären Bounces: wiederholte mailbox_full-Bounces von derselben Domain können auf ein Problem auf Anbieterebene hinweisen.
• Nutzen Sie das Zustellbarkeits-Dashboard: verfolgen Sie Bounce-Raten nach Anbieter, um domainspezifische Probleme frühzeitig zu erkennen.

Nächste SchritteLink zum Abschnitt kopieren

• Unterdrückungen: Unterdrückungsliste verwalten
• Zustellbarkeitsübersicht: Absender-Score und Trends überwachen
• Webhook-Ereignisse: message.bounced-Ereignisse empfangen