# Mailbox for developers An address for your application. Receive, read, and reply with context. [Get started](/dashboard/signup?returnTo=%2Fdashboard%2Fw%2Femail%2Fmailboxes) [Contact Sales](/demo?product=email) [Read customer stories](/customers) [Explore Enterprise](/enterprise) - [Airwallex](/customers/airwallex) - [Glovo](/customers/glovo) - [Zillow](/customers/zillow) - Uber - [Binance](/customers/binance) - Adobe - Meta - PayPal - Pinterest - Square - [Al Jazeera](/customers/aljazeera) - [Aramex](/customers/aramex) - [Bazaar Technologies](/customers/bazaar) - [ComparaOnline](/customers/compara) - [Emma](/customers/emma) ## From a prompt to a reply. Give your agent an inbox. Read the conversation and reply. Build with MCP, CLI or your preferred SDK. **MCP**: `Bird MCP` ```json https://mcp.bird.com ``` ## Read the reply. Keep the context. Read the new text and attachment. Reply in the same conversation. Harbor support a7f3k2@inbox.ai Inbox 1 MC Maya Chen09:42 Your delivery tomorrow Thanks, tomorrow works for me. Alex Lee A note about my order 08:35 Sam Kim Thank you, Harbor Yesterday Sent ### Your delivery tomorrow 2 participants · One conversation Harbor support Does tomorrow between 10 and 12 work? 09:40 MC Maya Chen 09:42 Thanks, tomorrow works for me. I’ve attached the delivery instructions. On Monday, Harbor support wrote: Does tomorrow between 10 and 12 work for your delivery? PDF Delivery instructions.pdf 1 attachment · 84 KB Reply to Maya Accepted From a7f3k2@inbox.ai Reply Reply accepted `Same thread · new outbound message` READY FOR YOUR AGENT Extracted text Thanks, tomorrow works for me. I’ve attached the delivery instructions. Quoted history removed HARBOR #### Delivery instructions. ORDER 42 Please use the side entrance. The bell is on the left. PDF · Available to read Inspect message context Thread thr_01harbor42 Incoming rem_01mayareply Reply em_01harborreply The reply uses the incoming message ID. Acceptance starts the send; delivery status follows on that message. [Explore threads and messages](/docs/guides/email/mailboxes#threads-and-messages) Receiving rulesHarbor support Default policy Replies only Block rule `spam.example` Maya’s replyBlocked sender offers@spam.example Blocked envelope sender Inbox Starts a webhook Filed quietly No mailbox webhook Stored outside the inbox Still readable. No new agent work. ### Give your agent the right mail. Admit replies and trusted senders. Blocked mail stays readable outside the inbox, without starting a webhook or another agent run. [Explore receiving rules](/docs/guides/email/mailboxes#deciding-what-gets-in) Message retention90-day tier Keep the useful part. Received on day 1 Day 40 Day 1 30 90 MC Maya Chen Thanks, tomorrow works for me. Extracted text available PDF Delivery instructions.pdf 1 attachment · 84 KB Original body & raw MIME 30-day window ended Read the retained text and attachment. Reply with new content. ### Keep context on your terms. Choose a retention tier your plan includes. Keep extracted text and attachments for longer. Inspect what remains available as the message ages. [Explore retention](/docs/guides/email/mailboxes#retention-and-erasure) ## Explore Mailbox. From a new inbox to a reply with context. Build the conversation into your app. [Mailbox API Create an inbox, read its conversations, and reply from your application.](#integrate)[Inboxes Create an email address for each application or agent task.](/docs/guides/email/mailboxes#addresses)[Custom domains Give the inbox an address on your own receiving domain.](/docs/guides/email/mailboxes#addresses)[Threads Keep sent and received messages in their conversation context.](/docs/guides/email/mailboxes#threads-and-messages)[Replies Answer in the original email conversation.](/docs/guides/email/mailboxes#sending)[Attachments Read the files that arrive with an email.](/docs/guides/email/mailboxes#threads-and-messages)[Receiving rules Choose which messages can start an inbox workflow.](/docs/guides/email/mailboxes#deciding-what-gets-in)[Webhooks Start work when a relevant mailbox event occurs.](/docs/guides/email/mailboxes#events)[Retention Choose a retention tier and see how long each type of content remains available.](/docs/guides/email/mailboxes#retention-and-erasure)[Compose Start a new email conversation from the mailbox address.](/docs/guides/email/mailboxes#sending) ## Scale without losing control. Organize teams in workspaces, control API access, and trace changes through audit logs. Harbor Organization Workspaces Production Sandbox ### Delivery agent API key · Customer operations team Active Permissions Access Email Read & write SMS Read & write WhatsApp Read Read & write AL Alex Lee Admin Permissions updated ### Audit log Production API key updated Alex Lee · 09:42:18 UTC Workspace Production Resource Delivery agent WhatsApp Read Read & write Succeeded [Workspaces](/docs/guides/workspaces)[Team roles](/docs/guides/users-teams-roles)[API authentication](/docs/guides/authentication) [Explore Enterprise](/enterprise) Examples: [MCP](/de-de/mailbox-api.mcp.md) · [CLI](/de-de/mailbox-api.cli.md) · [TypeScript](/de-de/mailbox-api.ts.md) · [Python](/de-de/mailbox-api.py.md) · [Go](/de-de/mailbox-api.go.md) ## Start with Mailbox. Build across channels with Bird. [Get started](/dashboard/signup?returnTo=%2Fdashboard%2Fw%2Femail%2Fmailboxes) · [Contact Sales](/demo) [Email](/email-api) · [SMS](/sms-api) · [WhatsApp](/whatsapp-api) · [Apple Messages](/apple-messages-api) · [Voice](/voice-api) ## Related resources - [Build with agent mailboxes](/docs/get-started/agent-mailboxes) (docs) [Get an implementation brief](/learn/workspace?topic=agent-mailboxes)