Sign inGet Started

Ihre erste E-Mail senden

Erstellen Sie einen API-Schlüssel, senden Sie über die gemeinsame Onboarding-Domain von Bird und prüfen Sie das Ergebnis. Sie müssen für diese Anleitung keine Versanddomain verifizieren und keine DNS-Einträge veröffentlichen. Verifizieren Sie Ihre eigene Domain, bevor Sie an Kunden senden.

1. Einen API-Schlüssel erstellen

Gehen Sie im Dashboard zu Developers > API keys und erstellen Sie einen Schlüssel. Schlüssel sind einer Region zugeordnet und sehen aus wie bk_us1_... oder bk_eu1_...; die Region im Präfix zeigt Ihnen, welchen API-Host Sie aufrufen müssen: https://us1.platform.bird.com oder https://eu1.platform.bird.com.
Die API-Keys-Seite im Bird-Dashboard mit Schlüsseln, ihrem maskierten Präfix, Berechtigungen und dem Zeitpunkt der letzten Nutzung
Der vollständige Schlüssel wird einmalig bei der Erstellung angezeigt. Kopieren Sie ihn an einen sicheren Ort und exportieren Sie ihn, damit die Snippets in Schritt 2 darauf zugreifen können:
Codebeispiel
export BIRD_API_KEY="bk_us1_..."

2. Eine E-Mail senden

Senden Sie von onboarding@messagebird.dev, der gemeinsamen Onboarding-Domain von Bird, die in Ihrem Workspace ohne weitere Einrichtung verfügbar ist. Adressieren Sie die Nachricht an delivered@messagebird.dev, einen Sandbox-Empfänger, der immer erfolgreich zustellt, sodass das Ergebnis ohne echtes Postfach deterministisch ist.
Der cURL-Aufruf verwendet den US-Host. Wenn Ihr Schlüssel mit bk_eu1_ beginnt, rufen Sie stattdessen https://eu1.platform.bird.com auf. Das SDK liest die Region aus Ihrem Schlüssel und wählt den Host aus. Der TypeScript-Tab erfordert npm install @messagebird/sdk.
import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const msg = await bird.email.send({
  from: { email: "onboarding@messagebird.dev", name: "Bird" },
  to: ["delivered@messagebird.dev"],
  subject: "Hello from Bird",
  html: "<p>My first Bird email.</p>",
});

console.log(msg.id, msg.status);
Vollständige Installations- und Ausführungsschritte für jede Sprache und jedes Framework finden Sie in den SDK-Quickstarts.

3. Das Ergebnis ansehen

Die API antwortet mit 202: Bird hat den Versand zur asynchronen Verarbeitung angenommen. Prüfen Sie den Zustellstatus separat. Die *_count-Felder verfolgen Empfänger durch die Zustellzustände. In der ersten Antwort ist ein Empfänger akzeptiert und keiner zugestellt.
Codebeispiel
{
  "id": "em_01ky7ma8y2es1s2akzk53tmjn0",
  "status": "accepted",
  "category": "marketing",
  "from": { "email": "onboarding@messagebird.dev" },
  "to": [{ "email": "delivered@messagebird.dev" }],
  "subject": "Hello from Bird",
  "accepted_count": 1,
  "processed_count": 0,
  "delivered_count": 0,
  "deferred_count": 0,
  "bounced_count": 0,
  "complained_count": 0,
  "rejected_count": 0,
  "open_count": 0,
  "click_count": 0,
  "track_opens": true,
  "track_clicks": true,
  "created_at": "2026-07-23T13:58:20.866Z"
}
Rufen Sie die Nachricht über ihre em_-ID ab, um den aktuellen Status zu sehen. Eine Nachricht durchläuft die Zustände von accepted über processed bis delivered. Fragen Sie ab, bis die Sandbox-Nachricht delivered erreicht:
const msg = await bird.email.get("em_abc123");
msg.status; // "accepted" | "processed" | "delivered" | "bounced" | …
msg.delivered_count;
msg.bounced_count;
Ersetzen Sie im cURL-Tab {region} und {message_id} und verwenden Sie $BIRD_API_KEY anstelle von $TOKEN.
Die Abfrage zeigt jetzt status: "delivered", delivered_count: 1 und einen delivered_at-Zeitstempel. Im Events-Leitfaden erfahren Sie, was delivered für einen echten Empfänger bedeutet.
Da Sie an delivered@messagebird.dev gesendet haben, ist das Ergebnis garantiert: Die Nachricht durchläuft die echte Zustellpipeline von Bird, einschließlich produktiver Event- und Webhook-Formate, berührt aber kein echtes Postfach. Um einen Bounce zu testen, senden Sie an bounce@messagebird.dev. Der Testing-Sandbox-Leitfaden listet alle Sandbox-Adressen und ihre simulierten Ergebnisse auf.

Über die Onboarding-Domain

Der gemeinsame onboarding@messagebird.dev-Absender steht für das Onboarding zur Verfügung und hat folgende Einschränkungen:
  • Abgesehen von den @messagebird.dev-Sandbox-Adressen wird nur an verifizierte Mitglieder Ihres Workspace zugestellt; jeder andere Empfänger wird mit einem 422 abgelehnt.
  • Der Versand ist auf 50 Empfänger pro Organisation pro UTC-Tag begrenzt, wobei jede to-, cc- und bcc-Adresse mitgezählt wird, Sandbox-Empfänger eingeschlossen. Nach Erreichen des Limits gibt die API einen 429 zurück.
Wenn Sie echte Kunden per E-Mail erreichen möchten, verifizieren Sie Ihre eigene Versanddomain und tragen Sie Ihre eigene Adresse in from ein; alles andere im Request bleibt gleich.

Nächste Schritte