Die Mailbox API für Agenten, die ihre eigenen E-Mails beantworten.
Ein echtes Postfach, das Ihr Code besitzt. E-Mails landen als Threads; Ihr Agent liest und antwortet über die API. Kein IMAP, kein MIME-Parsing.
# Claim an address on inbox.ai
curl -X POST https://us1.platform.bird.com/v1/email/mailboxes \
-H "Authorization: Bearer $BIRD_API_KEY" \
-d '{
"domain": "inbox.ai",
"local_part": "goldcrest",
"display_name": "Goldcrest Support"
}'
{
"id": "mbx_01krdgeqcxet5s7t44vh8rt9mg",
"address": "goldcrest@inbox.ai",
"receive_policy": "open",
"state": "active"
}
# Mail arrives; your webhook fires
POST /your-webhook-endpoint
{ "type": "email_mailbox.message_received", "data": { "thread_id": "thr_…", … } }
Beanspruchen, verfassen und antworten – in der Sprache, die Sie bereits nutzen.
SDKs, CLI und der gehostete MCP-Server sprechen denselben Loop.
Jede Oberfläche führt dieselben vier Aufrufe aus: Adresse beanspruchen, auf einen Webhook warten, den neuen Inhalt lesen und antworten. Wählen Sie Ihre Runtime – der Vertrag ist identisch.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
// Claim an address on inbox.ai
const mailbox = await bird.mailbox.create({
domain: "inbox.ai",
local_part: "support",
display_name: "Acme Support",
receive_policy: "open",
});
// Send a message from the mailbox
await bird.mailbox.compose(mailbox.id, {
to: ["alice@example.com"],
subject: "Your request has been received",
text: "We'll get back to you within one business day.",
});
Beanspruchen, empfangen, lesen, antworten.
Der gesamte Loop besteht aus vier Aufrufen.
Die Adresse gehört Ihnen ab dem ersten Aufruf, und auf inbox.ai ist sie dauerhaft für Ihre Organisation reserviert. Kein Polling: Schritt 02 ist das Aufwecken per Webhook. Die Beispiele sind reines REST; die SDKs, die CLI und der gehostete MCP-Server führen denselben Loop aus.
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"
}
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"
}
Sie entscheiden, was reinkommt.
Nichts verschwindet.
Eine Empfangsrichtlinie und absenderspezifische Regeln prüfen den Envelope-Sender; ein Block schlägt immer ein Allow. Von einer Absenderregel blockierte Mails werden stillschweigend gespeichert – Sie können sie weiterhin lesen, und es werden keine Webhooks ausgelöst. (Die `drop`-Richtlinie verwirft Mails vollständig und speichert sie nicht.)
Das Modell liest die Nachricht.
Not the old replies.
Jede Nachricht stellt Header, HTML, Rohquelle und Anhänge bereit. Das Feld, das Ihr Agent tatsächlich braucht, ist extracted_text: der neue Inhalt, ohne Zitate. Kontext liegt im Thread, nicht in vierzig Zeilen Quoting.
Wofür Sie Mailboxes nutzen können.
Vier Aufgaben, die eine Mailbox ab dem ersten Tag erledigt.
Ein Support-Postfach, das der Agent betreibt.
Jede Konversation ist ein Thread; der Agent antwortet im Thread und markiert unsichere Fälle mit einem Label, das ein Mensch überwacht.
Alles in der Box.
Die gesamte Oberfläche auf einen Blick.
Inbox API.
Beanspruchen Sie eine Adresse mit einem einzigen Aufruf: generiert auf inbox.ai, ein benutzerdefiniertes Handle oder Ihre eigene Domain.
MCP & SDKs.
Ein gehosteter MCP-Server für Agents; SDKs und die CLI für alles andere.
Threads & Labels.
Ein Thread pro Konversation; Labels im Gmail-Stil mit einer einzigen PATCH-Grammatik.
extracted_text.
Der neue Inhalt, ohne Zitate, bereit zur Übergabe an das Modell.
Anhänge.
Header, HTML, Rohquelle und Anhänge – alles über die API.
Events.
Die email_mailbox.*-Webhook-Familie: message_received, thread_created, message_sent, message_delivered, message_failed.
Empfangsregeln.
Eine Richtlinie plus absenderspezifisches Allow und Block, geprüft gegen den Envelope-Sender.
Thread-Filter.
Filtern Sie die Threads jeder Mailbox nach Label, Teilnehmer, Betreff oder Lesestatus über die API.
Zugriffsschlüssel mit Geltungsbereich.
mailbox liest und schreibt Konversationen; mailbox_management verwaltet.
Versand mit Unterdrückungslisten-Prüfung.
Antworten werden als Marketing oder Transaktional deklariert; die Unterdrückungsliste wird nach Kategorie durchgesetzt.
E-Mail trifft ein.
Ihr Agent wird geweckt.
Webhooks für zuverlässige Zustellung. Nur E-Mails, die den Posteingang erreichen, lösen Webhooks aus – Spam und blockierte E-Mails werden stillschweigend gespeichert.
POST /your-webhook-endpoint HTTP/1.1
Content-Type: application/json
{
"type": "email_mailbox.message_received",
"timestamp": "2026-07-23T14:11:02Z",
"data": {
"thread_id": "thr_01krdh2p8qz3m9wv6xf0abcnde",
"message_id": "rem_01krdh3v7t2j5nqx8fw4mzp6bc"
}
}
email_mailbox.message_receivedEingehende E-Mail hat den Posteingang erreicht.email_mailbox.thread_createdEine neue Konversation wurde eröffnet.email_mailbox.message_sentEine Antwort oder neue Nachricht hat die Mailbox verlassen.email_mailbox.message_deliveredDer empfangende Server hat sie akzeptiert.email_mailbox.message_failedZustellung fehlgeschlagen; der Status wird der Nachricht zugeordnet.
Preise
Mailboxen sind in Ihrem Email-Plan enthalten
Es gibt kein separates Mailbox-Abo. Jeder Email-Plan enthält Mailboxen mit generierten @inbox.ai-Adressen; kostenpflichtige Pläne bieten benutzerdefinierte Handles.
Kostenlos
$0
Startup
ab 15 $/Monat
Growth
ab 80 $/Monat
Enterprise
Individuell
Mailboxen (beliebige Domain)
5
ab 50
ab 100
Individuell
Benutzerdefinierte @inbox.ai-Handles
—
ab 10
ab 25
Individuell
Generierte @inbox.ai-Adressen
Unbegrenzt innerhalb Ihres Postfach-Kontingents, in jedem Plan kostenlos
Handles auf Ihrer eigenen Domain
Beliebiges Handle, kein Kontingent verbraucht
Thread-Aufbewahrung
30 Tage in jedem Plan
Wiederherstellungsfenster nach Löschung
Gelöschte Postfächer haben ein 30-tägiges Wiederherstellungsfenster. Inbox.ai-Adressen bleiben dauerhaft für Ihre Organisation reserviert; Custom-Domain-Adressen können nach 30 Tagen vom selben Workspace neu zugewiesen werden.
Kontingente wachsen mit dem E-Mail-Volumen Ihres Plans. Downgrades deaktivieren nie ein Postfach: Bereits beanspruchte Handles funktionieren weiterhin – Sie können nur keine neuen beanspruchen, bis Sie wieder unter dem Kontingent liegen.