Suppressions

Schluss mit dem Versand an Adressen, die dir schaden.

Eingerichtet in:
Cursor

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.

welcome.tsx
200 · 1.2s
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..."

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.

  1. 01

    Automatisch bei Bounce + Beschwerde.

    Hard Bounces, Spam-Beschwerden und Abmeldungen unterdrücken den Empfänger automatisch. Kein Code nötig.

  2. 02

    Reversibel.

    Nichts ist endgültig. Entferne eine Adresse, wenn sie sich erholt, und nimm den Versand wieder auf.

  3. 03

    Manuelle Einträge.

    Füge Adressen selbst hinzu: etwa eine bekannte Schlecht-Liste, die du von einem anderen Provider importierst.

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

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

suppressions.sh
bird CLI
# 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.

GrundAusgelöst durchBlockiert
hard_bounceein permanenter Bouncealle Mails (transaktional + Marketing)
complainteine Spam-Beschwerdenur Marketing
unsubscribeeine Listen- oder One-Click-Abmeldungnur Marketing
manualdu, per API oder Dashboardalle 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.

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.

Starten Sie mit einem Kanal.
Fügen Sie die anderen hinzu, wenn Sie bereit sind.

Ein Test-API-Key steht Ihnen sofort zur Verfügung. Der Produktivzugang wird freigeschaltet, sobald Sie eine Zahlungsmethode hinzufügen und einen Absender verifizieren.

Sie nutzen Claude Code, Cursor oder Codex? Kopieren Sie einen Setup-Prompt und Ihr Agent installiert die Bird CLI und Skills für Sie. Wählen Sie Ihren:

Cursor