De Mailbox API voor agents die hun eigen e-mail beantwoorden.
Een echte inbox waar uw code de eigenaar van is. Mail komt binnen als threads; uw agent leest en beantwoordt via de API. Geen IMAP, geen 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_…", … } }
Claim, stel op en beantwoord in de taal die u al gebruikt.
SDK's, CLI en de gehoste MCP-server spreken dezelfde loop.
Elk oppervlak draait dezelfde vier calls: claim een adres, wacht op een webhook, lees de nieuwe inhoud en beantwoord. Kies uw runtime; het contract is identiek.
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.",
});
Claim, ontvang, lees, beantwoord.
De hele loop is vier calls.
Het adres is van u vanaf de eerste call, en op inbox.ai is het permanent gereserveerd voor uw organisatie. Er wordt niet gepolld: stap 02 is de wake, via webhook. De voorbeelden zijn plain REST; de SDK's, de CLI en de gehoste MCP-server draaien dezelfde loop.
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"
}
U bepaalt wat binnenkomt.
Niets verdwijnt.
Een ontvangstbeleid en regels per afzender worden getoetst aan de envelope-afzender; een blokkering wint altijd van een toelating. E-mail die door een afzenderregel wordt geblokkeerd, wordt stilzwijgend opgeslagen — u kunt het nog steeds lezen, en er worden geen webhooks afgevuurd. (Het `drop`-beleid verwijdert e-mail volledig en slaat het niet op.)
Het model leest het bericht.
Not the old replies.
Elk bericht toont headers, HTML, ruwe bron en bijlagen. Het veld dat uw agent daadwerkelijk nodig heeft, is extracted_text: de nieuwe inhoud, ontdaan van quotes. Context zit in de thread, niet in veertig regels aan citaten.
Waarvoor u Mailboxes kunt gebruiken.
Vier taken die een mailbox vanaf dag één uitvoert.
Een support-inbox die de agent beheert.
Elk gesprek is een thread; de agent beantwoordt in-thread en markeert onzekere berichten met een label dat een mens in de gaten houdt.
Alles in de mailbox.
Het volledige overzicht in één oogopslag.
Inbox API.
Claim een adres in één aanroep: gegenereerd op inbox.ai, een aangepast handle, of uw eigen domein.
MCP & SDKs.
Een gehoste MCP-server voor agents; SDKs en de CLI voor al het andere.
Threads & labels.
Eén thread per gesprek; Gmail-achtige labels met een eenvoudige PATCH-grammatica.
extracted_text.
De nieuwe inhoud, ontdaan van quotes, klaar om aan het model te geven.
Bijlagen.
Headers, HTML, ruwe bron en bijlagen, allemaal via de API.
Events.
De email_mailbox.* webhookfamilie: message_received, thread_created, message_sent, message_delivered, message_failed.
Ontvangstregels.
Een beleid plus toelating en blokkering per afzender, getoetst aan de envelope-afzender.
Threadfilters.
Filter de threads van elke mailbox op label, deelnemer, onderwerp of leesstatus via de API.
Scoped keys.
mailbox leest en schrijft gesprekken; mailbox_management beheert.
Suppressiebewuste verzendingen.
Antwoorden worden aangemerkt als marketing of transactioneel; de suppressielijst wordt per categorie gehandhaafd.
Mail komt binnen.
Uw agent wordt wakker.
Webhooks voor duurzame aflevering. Alleen mail die in de inbox belandt, wordt doorgestuurd naar webhooks — spam en geblokkeerde mail wordt stilzwijgend opgeslagen.
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_receivedInkomende mail heeft de inbox bereikt.email_mailbox.thread_createdEen nieuw gesprek is geopend.email_mailbox.message_sentEen antwoord of nieuw bericht heeft de mailbox verlaten.email_mailbox.message_deliveredDe ontvangende server heeft het geaccepteerd.email_mailbox.message_failedAflevering mislukt; de status wordt teruggekoppeld op het bericht.
Prijzen
Mailboxes zijn inbegrepen bij uw Email-abonnement
Er is geen apart mailbox-abonnement. Elk e-mailabonnement bevat mailboxes met gegenereerde @inbox.ai-adressen; betaalde abonnementen voegen aangepaste handles toe.
Gratis
$0
Startup
vanaf $15/mnd
Growth
vanaf $80/mnd
Enterprise
Op maat
Mailboxes (elk domein)
5
vanaf 50
vanaf 100
Op maat
Aangepaste @inbox.ai-handles
—
vanaf 10
vanaf 25
Op maat
Gegenereerde @inbox.ai-adressen
Onbeperkt binnen uw aantal mailboxen, gratis bij elk abonnement
Handles op uw eigen domein
Elke handle, geen tegoed gebruikt
Threadretentie
30 dagen bij elk abonnement
Herstelperiode na verwijdering
Verwijderde mailboxen komen in een herstelperiode van 30 dagen. Inbox.ai-adressen blijven permanent gereserveerd voor uw organisatie; adressen op een eigen domein kunnen na 30 dagen opnieuw worden gekoppeld door dezelfde workspace.
Tegoeden groeien mee met het e-mailvolume van uw abonnement. Downgrades breken nooit een mailbox: handles die u al heeft geclaimd blijven werken, u kunt alleen geen nieuwe claimen totdat u weer binnen het tegoed valt.