Understand why a send stopped.
Read the suppression reason and applicable category. A manual restriction, a complaint and a bounce can have different origins; preserve the information needed to review the decision.
Read suppression behavior ↗Keep delivery restrictions with the sending decision. Understand why a recipient is suppressed and avoid repeating a known ineligible send.
Understand why an address is excluded before the next send. Review its history alongside the message category and the customer’s preferences.
The address belongs to the selected example audience.
A bounce, complaint or manual migration record carries its own reason and scope.
Customer preference and suppression are evaluated separately.
{
"recipient": "alex@example.com",
"reason": "hard_bounce",
"applies_to": "all",
"category": "marketing",
"preference": "allowed",
"replayed_decision": false
}No current decision. Trace this reason, category and preference; changing inputs clears the previous result.
Customer policy excludes this recipient even if this suppression record allows the category.
The scope is unrecognized. Keep the recipient excluded and inspect the documented policy; unknown scope is not sending permission.
The recorded restriction blocks this category. Audience membership and a repeated event do not erase it.
This complaint record alone does not block the transactional example. Other suppressions, preferences and account policy still need checking before a send.
Repeated evaluation: the same restriction remains authoritative. No new record or send was created.
Companies that trust Bird across their communications.
Read Bird customer storiesRead the suppression reason and applicable category. A manual restriction, a complaint and a bounce can have different origins; preserve the information needed to review the decision.
Read suppression behavior ↗A migration needs recipient restrictions as well as addresses. Keep contact permission and unsubscribe preferences separate, and investigate incomplete exports before moving a cohort.
Prepare the migration ↗Suppression ist in die Bird Email API integriert. Hard-Bounce-Einträge stoppen E-Mails an ungültige Adressen, und Beschwerdeeinträge stoppen nicht-transaktionale E-Mails. Sie können den Grund und die auslösende Nachricht einsehen, um nachzuvollziehen, warum ein Empfänger abgelehnt wurde.
Automatisch, reversibel und abfragbar.
Hard Bounces und Spam-Beschwerden erzeugen Suppression-Einträge automatisch. Abmeldungen erscheinen unter Preferences.
Untersuchen Sie die Ursache, bevor Sie eine Suppression entfernen. Andere blockierende Einträge und Opt-out-Präferenzen bleiben bestehen.
Fügen Sie Adressen selbst hinzu: etwa eine Liste bekannter ungültiger Adressen, die Sie von einem anderen Anbieter importieren.
Lassen Sie die gesamte Liste anzeigen, filtern Sie nach Adresse oder Grund, fügen Sie einen Eintrag hinzu oder löschen Sie einen anhand seiner Datensatz-ID – so bleiben Ihre eigenen Systeme stets synchron.
Hard-Bounce- und manuelle Suppressions blockieren alle Kategorien. Beschwerden blockieren nicht-transaktionale E-Mails. Die Präferenzen eines Empfängers werden separat geprüft.
Sie müssen die Liste nicht manuell pflegen, damit sie funktioniert; Bounces und Beschwerden werden automatisch unterdrückt. Wenn Sie doch eingreifen müssen, steht Ihnen die gesamte Liste als API zur Verfügung: Fügen Sie eine Adresse hinzu, die bereits als ungültig bekannt ist, filtern Sie nach Adresse oder Grund, oder löschen Sie einen Datensatz, um einen wiederhergestellten Empfänger erneut zuzulassen. Die Bird CLI deckt das Auslesen und Entfernen ab, und ein Agent greift über MCP auf dieselben beiden Funktionen zu.
# Look up why an address is on the list.
$ bird email suppressions list --email ada@example.com \
| jq -c '.data[] | {id, reason, applies_to}'
{"id":"sup_01krdgeqcxet5s7t44vh8rt9mg","reason":"hard_bounce",
"applies_to":"all"}
# Reinstate one that recovered, by record id.
$ bird email suppressions remove sup_01krdgeqcxet5s7t44vh8rt9mg --yes
Look up a suppression with CLI or MCP before changing it. Review the reason and the recipient’s consent before deciding whether to resume sending.
Hard Bounces und manuelle Einträge blockieren alle E-Mails. Beschwerden blockieren nicht-transaktionale E-Mails. Eine Abmeldung erzeugt eine separate Präferenz; das Entfernen einer Suppression löscht diese Präferenz nicht.
| Grund | Ausgelöst durch | Blockiert |
|---|---|---|
| hard_bounce | ein permanenter Bounce | alle Mails (transaktional + Marketing) |
| complaint | eine Spam-Beschwerde | nur Marketing |
| manual | Sie, über die API oder das Dashboard | alle Mails (transaktional + Marketing) |
Lies im Suppressions-Guide nach, wie automatische und manuelle Suppression funktionieren, und im Deliverability-Guide, wie sie ins größere Bild passt.
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.
Follow an opt-out, complaint and imported record without losing their meaning.
Ihre Kontakte und die Zielgruppen, die Sie über einen Broadcast ansprechen.
Authentifizierung, IP-Warmup, Suppression und Sichtbarkeit pro Provider.
Zustellungs- und Engagement-Metriken pro Mailbox-Provider, Domain und IP.
Die komplette Email-API: Versand, Deliverability, IPs, Suppression, Analytics und Broadcasts.
Sprechen Sie mit unserem E-Mail-Team
Besprechen Sie Opt-outs, Suppressionsimporte und Steuerungsmöglichkeiten auf Anwendungsebene. Wir helfen Ihnen zu planen, wie Empfängerpräferenzen mit Ihrem E-Mail-Versand mitgeführt werden.
Erstellen Sie Ihr Konto und prüfen oder importieren Sie die Empfänger, die Sie ausschließen möchten.
Ein Test-API-Key steht Ihnen sofort zur Verfügung. Der Produktivzugang wird freigeschaltet, sobald Sie eine Zahlungsmethode hinzufügen und einen Absender verifizieren.
Dokumentation lesen