CLI

Senden Sie Ihre erste E-Mail von einem macOS- oder Linux-Terminal: Installieren Sie die bird CLI, melden Sie sich einmal an und senden Sie. Sie müssen keinen API-Key kopieren.

1. Installieren

Codebeispiel

curl -fsSL https://cli.bird.com/install.sh | sh

Führen Sie bird version aus, um die erfolgreiche Installation zu bestätigen. Für Windows und weitere Installationsoptionen siehe CLI installieren.

2. Anmelden

Codebeispiel

bird auth login --scope emails:write

Dies öffnet eine Browser-Zustimmungsseite, auf der Sie einen Workspace auswählen und die Berechtigung erteilen. Der Scope emails:write ermöglicht das Senden in Schritt 3. Ohne ihn fordert bird auth login nur Lesezugriff an und der Sendevorgang wird abgelehnt. Die CLI speichert ein Workspace-gebundenes OAuth-Token in ~/.config/bird/credentials.json, aktualisiert es bei Bedarf und speichert die Workspace-Region.

3. Eine E-Mail senden

Senden Sie von der gemeinsamen Onboarding-Domain von Bird an die delivered@messagebird.dev-Sandbox-Adresse: keine Domain-Verifizierung, kein echtes Postfach nötig.

Codebeispiel

bird email send \
  --from onboarding@messagebird.dev \
  --to delivered@messagebird.dev \
  --subject "Hello from Bird" \
  --html "<p>My first Bird email.</p>"

Die CLI gibt die akzeptierte Nachricht als JSON aus. Die *_count-Felder verfolgen Empfänger durch die Zustellungsstatus. 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"
}

--to ist für mehrere Empfänger wiederholbar, --text sendet einen Klartext-Body und --dry-run gibt die aufgelöste Anfrage aus, ohne sie zu senden.

4. Ergebnis prüfen

accepted bedeutet, dass Bird die Nachricht angenommen hat und sie asynchron zustellt. Lesen Sie sie anhand ihrer em_-ID zurück und beobachten Sie, wie der Status delivered erreicht:

Codebeispiel

bird email get em_01ky7ma8y2es1s2akzk53tmjn0

Fügen Sie --format text hinzu, um statt JSON eine lesbare Karte zu erhalten.

Jeder Befehl schreibt standardmäßig JSON auf die Standardausgabe. Fehler verwenden eine JSON-Fehlerantwort auf der Standardfehlerausgabe, und Exit-Codes kennzeichnen Fehlerkategorien. Siehe die CLI für Agents für den vollständigen Vertrag.

Nächste Schritte

CLI-Referenz: Installation, Authentifizierung, der Ausgabevertrag und die wichtigsten Befehlsgruppen.
Die CLI für Agents: JSON-Ausgabe, Exit-Codes, --dry-run und idempotente Wiederholungsversuche.
Ihre erste E-Mail senden: derselbe Ablauf über rohes HTTP und die SDKs.
Sendedomains: Verifizieren Sie Ihre eigene Domain für den Produktivversand.

CLI

1. Installieren

2. Anmelden

3. Eine E-Mail senden

4. Ergebnis prüfen

Nächste Schritte

Verwandte Ressourcen