---
title: "Mailbox for developers"
canonical: "https://bird.com/mailbox-api"
---

# 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`

Connect this hosted MCP endpoint with an [MCP client](/docs/ai/mcp-server#connect-a-client), then complete OAuth sign-in to your Bird workspace.

Example prompt: Find Maya’s email about tomorrow’s delivery in our Harbor mailbox. Read the thread, then reply to confirm we received her delivery instructions.

```text
https://mcp.bird.com
```

Examples: [MCP](/mailbox-api.mcp.md) · [CLI](/mailbox-api.cli.md) · [TypeScript](/mailbox-api.ts.md) · [Python](/mailbox-api.py.md) · [Go](/mailbox-api.go.md)

## Read the reply. Keep the context.

Read the new text and attachment. Reply in the same conversation.

[Explore threads and messages](/docs/guides/email/mailboxes#threads-and-messages)

### 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)

### 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.

[Workspaces](/docs/guides/workspaces)[Team roles](/docs/guides/users-teams-roles)[API authentication](/docs/guides/authentication)
[Explore Enterprise](/enterprise)



## 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)

[Mailbox pricing](/pricing/mailbox)



## Related resources

- [Build with agent mailboxes](/docs/get-started/agent-mailboxes) (docs)

[Get an implementation brief](/learn/workspace?topic=agent-mailboxes)