Suppressions
Schluss mit dem Versand an Adressen, die dir schaden.
Jeder Bounce, jede Beschwerde und jede Abmeldung fügt den Empfänger automatisch deiner Suppression-Liste hinzu, damit du ihn nicht erneut anschreibst. Suppression ist reversibel, über die API abfragbar und gilt für transaktionale und Marketing-Sends.
import { BirdClient } from "@messagebird/sdk";
import { render } from "@react-email/render";
import { WelcomeEmail } from "./emails/welcome";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
const { data, error } = await bird.email.send({
from: "Bird <hello@bird.com>",
to: ["ada@example.com"],
subject: "Your invite is ready",
html: await render(<WelcomeEmail name="Ada" />),
}).safe();
if (error) throw error;
console.log(data.id);
// → "em_2bX91Yk8h..."
You can sign in any time at bird.com/login.
Your test API key is on your dashboard, ready to send.
Der größte Hebel für deine Reputation.
Suppression ist direkt in die Bird Email API integriert – keine Liste, die Sie manuell pflegen müssen. Mailbox-Provider bestrafen Absender, die wiederholt ungültige Adressen und Spam-Trap-Beschwerden auslösen. Diese Zustellungen werden automatisch für Sie gestoppt, sobald ein Empfänger ungültig wird.
Fünf Wege, wie Suppression dich schützt.
Automatisch, reversibel und abfragbar.
- 01
Automatisch bei Bounce + Beschwerde.
Hard Bounces, Spam-Beschwerden und Abmeldungen unterdrücken den Empfänger automatisch. Kein Code nötig.
- 02
Reversibel.
Nichts ist endgültig. Entferne eine Adresse, wenn sie sich erholt, und nimm den Versand wieder auf.
- 03
Manuelle Einträge.
Füge Adressen selbst hinzu: etwa eine bekannte Schlecht-Liste, die du von einem anderen Provider importierst.
- 04
Über die API abfragbar.
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.
- 05
Eine Liste, jeder Send.
Suppression gilt für transaktionale und Marketing-Mails, damit eine Kampagne keine Adresse erneut anschreibt, an die gerade eine Quittung gebounct ist.
Standardmäßig automatisch, von dir steuerbar.
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
Vier Gründe, zwei Geltungsbereiche.
Nicht jede Suppression blockiert jeden Send. Ein Empfänger, der sich vom Marketing abgemeldet hat, bekommt trotzdem sein Passwort-Reset: Beschwerden und Abmeldungen gelten nur fürs Marketing, während Hard Bounces und manuelle Einträge alles blockieren.
| Grund | Ausgelöst durch | Blockiert |
|---|---|---|
| hard_bounce | ein permanenter Bounce | alle Mails (transaktional + Marketing) |
| complaint | eine Spam-Beschwerde | nur Marketing |
| unsubscribe | eine Listen- oder One-Click-Abmeldung | nur Marketing |
| manual | du, per API oder Dashboard | alle Mails (transaktional + Marketing) |
Geh tiefer in die Docs.
Lies im Suppressions-Guide nach, wie automatische und manuelle Suppression funktionieren, und im Deliverability-Guide, wie sie ins größere Bild passt.
Der Rest der Email-Plattform
Eine API, ein Satz Keys. Entdecke die anderen Funktionen.
Rund 40 % der kommerziellen Email weltweit laufen bereits über Bird.
Transaktionale und Marketing-Email auf einer Infrastruktur, die wir seit einem Jahrzehnt betreiben. Suppression ist eine Funktion der Bird Email-API: Versand, Deliverability, dedizierte IPs und Analytics kommen direkt mit.