Bird Produkte

Eleven surfaces. One platform. Same shape.

Email, Mailbox, SMS, Voice, WhatsApp, Verify, Lookup, RCS, Push, Realtime, and eSIM — each a first-class API. Same auth, same idempotency, same webhooks, same error envelope. Learn one, you've learned them all.

Einrichtung in:
Cursor

Alle Produkte. Eleven surfaces, one SDK.

01POST /v1/emails

Email. Die Email-API für Entwickler, die auch den Rest der Nachricht versenden.

welcome.tsx
await bird.email.send({
  from: "hello@yourdomain.com",
  to: ["alex@example.com"],
  subject: "Welcome to Bird",
  html: "<p>You're in. Let's ship.</p>",
});
02POST /v1/email/mailboxes

Mailbox. Die Mailbox-API für Agenten, die ihre E-Mails selbst beantworten.

claim-mailbox.sh
curl -X POST https://us1.platform.bird.com/v1/email/mailboxes \
  -H "Authorization: Bearer $BIRD_API_KEY" \
  -d '{"domain": "inbox.ai", "receive_policy": "open"}'

{
  "id": "mbx_01krdgeqcxet5s7t44vh8rt9mg",
  "address": "k7mq3vx2npr5wcj4tzh6@inbox.ai",
  "state": "active"
}
03POST /v1/sms/messages

SMS. Die SMS-API für Entwickler, die wirklich liefern müssen.

notify.ts
await bird.sms.send({
  to: "+15005550006",
  text: "Your code is 847291. Expires in 10 min.",
  category: "authentication",
});
04GET /v1/voice/calls

Voice. SIP trunking, with a record and events on every call.

dial.ts
const call = await bird.voice.get("vcl_01k0p3v9wera3v6q6xw3e9y2mh");

call.status; // "answered" | "no_answer" | "ringing" | …
Voice wird aktualisiert
05POST /v1/whatsapp/messages

WhatsApp. Erreichen Sie Kunden weltweit mit der WhatsApp API.

message.ts
await bird.whatsapp.send({
  from: "+15557654321",
  to:   "+15005550006",
  text: { body: "Order confirmed! 🎉" },
});
06POST /v1/verify/verifications

Verify. Die OTP-API für Entwickler, deren Codes auch ankommen müssen.

verify.ts
await bird.verify.verifications.create({
  to: { phone_number: "+15005550006" },
});
// check by target — no id to store
await bird.verify.verifications.check({
  to: { phone_number: "+15005550006" }, code: userCode,
});
07POST /v1/lookup/phone-number

Lookup. Überprüfen Sie eine Telefonnummer oder E-Mail-Adresse, bevor Sie eine Nachricht senden.

lookup.ts
await bird.lookup.phoneNumber({
  phone_number: "+31612345678",
});
08POST /v1/rcs

RCS. Die RCS for Business API, das attraktivere Geschwisterkind von SMS.

rich.ts
await bird.rcs.send({
  to: "+15005550006",
  text: "Your order shipped! 📦",
  suggestions: [
    { type: "openUrl", text: "Track it", url },
  ],
});
RCS wird aktualisiert
09POST /v1/push

Push. Push-Benachrichtigungen für iOS, Android und Web.

push.ts
await bird.push.send({
  to: { deviceToken },
  notification: {
    title: "Order shipped!",
    body: "Your package is on its way.",
  },
});
Push wird aktualisiert
10POST /v1/realtime/publish

Realtime. Gehostetes Pub/Sub über WebSocket. Abonnieren, veröffentlichen, skalieren.

realtime.ts
await bird.realtime.publish("rap_01krdgeqcxet5s7t44vh8rt9mg", {
  channels: ["orders"],
  event: "order.shipped",
  data: { orderId, status: "shipped" },
});
11POST /v1/esims

eSIM. Corporate eSIMs, employee phone plans, connectivity in your product.

esim.ts
await bird.esim.issue({
  recipient: { externalId: employeeId },
  plan: { region: "eu", dataMb: 5_000 },
  policy: { blockStreaming: true },
});
The eSIM API is coming to Bird

Jedes der obigen Produkte teilt ein Auth-Modell, einen Idempotenz-Vertrag, ein Fehlerformat, einen Webhook-Vertrag und ein Cursor-Paginierungsschema. Lernen Sie eines kennen, kennen Sie alle.

/ Auth

/ Idempotency

/ Errors

/ Webhooks

/ Pagination

/ Typed IDs

Zu den API-Endpunkten

Put it into practice.

Continue with the documentation, guides and examples for this topic. Resources are in English.

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