Give your application or agent an email address, messages, and persistent threads. Read the conversation, prepare a useful reply, and apply your own review policy.
Your agent workspaceIllustrative application · API productHi Fieldnotes, could we move the booking to Friday afternoon? The original booking is attached.
Your agent workspaceIllustrative application · API productHi Fieldnotes, could we move the booking to Friday afternoon? The original booking is attached.
Your agent has the details to prepare a useful response.
Your agent workspaceIllustrative application · API productHi Fieldnotes, could we move the booking to Friday afternoon? The original booking is attached.
Hi Alex, thanks for sending the booking. I’ll check Friday afternoon with the studio before changing FN–1042.
Review required before sendingYour application defines approval and send permissions.Companies that trust Bird across their communications.
Read Bird customer storiesThreads hold incoming and outgoing messages. Original bodies and received MIME remain available for 30 days; retained extracted content follows the supported mailbox retention tier.
Read the product guide ↗Documented behavior; confirm current access and setup in your workspace.Read the attachment context, edit the response and review it before queuing an example reply. Your application owns the agent experience and its permission to act.
thr_example_fn1042Hi Fieldnotes, could we move booking FN–1042 to Friday afternoon? The original booking is attached.
Day 10 example: retained extracted text, original bodies and received MIME are within their content windows.
Day 40 example: extracted text and eligible retained attachments remain readable. Original HTML, plain-text bodies and received raw MIME have expired. A reply with new content is possible; the expired original cannot be restored by raising the tier.
Inbox admission can wake a mailbox webhook. The event does not verify the sender’s identity. Check authentication and your application’s authority separately.
A block rule wins over an allow rule. Blocked mail is stored outside the inbox and does not wake a mailbox webhook. Rules match the envelope sender.
The drop policy discards incoming mail before storage. This previously received illustrative thread remains on screen; the policy preview does not delete it.
Generated inbox.ai addresses are available within workspace limits. A chosen shared handle needs a paid-plan allowance; your own domain must be enabled for receiving. Use mailbox and mailbox_management scopes for the operations your application needs.
Review is required before this example reply can be queued. Editing the draft or changing context clears approval.
Review this draft before queuing the example reply. No reply was queued.
Write a reply before submitting. Whitespace alone cannot be sent.
Example refused: approval in the interface does not grant send authority. The server must enforce the authenticated caller’s permissions. No new reply was queued.
Reviewed example queued once in this thread. This is an illustrative outcome; the booking is unchanged and delivery has not been observed.
mailbox: mbx_example_studio
thread: thr_example_fn1042
received: rem_example_fn1042
POST /v1/email/mailboxes
GET /v1/email/threads?mailbox_id={mailbox_id}
GET /v1/email/threads/{thread_id}/messages/{message_id}
POST /v1/email/threads/{thread_id}/messages/{message_id}/replyFollow the mailbox quickstart ↗Combine an agent mailbox with outbound Email, WhatsApp, and a human support workflow. Keep the business decision in the systems that own it.
Alex Lee · Original booking attached
Alex’s message and attachment stay associated with thread FN–1042.
Hi Alex, we checked with the studio.After your application confirms the booking change, an authorized reply is queued and its delivery status folds back into the thread.
Your application can offer a different channel with the customer’s permission.
Give your application a place to receive, understand, and respond. Keep the thread together while your product decides what happens next.
Create a generated inbox.ai address or use a receiving-enabled domain your business owns.
Read the latest message alongside the conversation. Extracted text helps your agent focus on what changed.
Let your application draft, send, or ask a person to review. Your policy decides when the agent acts.
Use an address with retained threads, messages, and reply operations when the conversation is part of your application.
Open the mailbox guide ↗Receive parsed content and attachments into a webhook workflow when you do not need a persistent mailbox conversation.
Compare Inbound email ↗Inbox mail can emit email_mailbox.message_received and email_mailbox.thread_created. Outgoing replies have message_sent, message_delivered and message_failed events. Receiving-server acceptance is separate from inbox placement. Reconcile thread and message IDs after a delivery gap before creating another reply.
Read the mailbox lifecycle ↗Verify webhook deliveries and handle retries ↗These server-side examples create a custom support@inbox.ai handle, then compose a new outbound message. A custom handle needs a paid plan and must be globally available. Use mailbox_management and mailbox key scopes. Replace the example recipient with an address you control, and enforce application authorization before composing.
Read the incoming thread, inspect its message body and reply through the CLI or MCP. A reply sends a real email; confirm the recipient and inspect the returned message before continuing.
npm install @messagebird/sdkimport { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
// Claim an address on inbox.ai
const mailbox = await bird.email.mailboxes.create({
domain: "inbox.ai",
local_part: "support",
display_name: "Acme Support",
receive_policy: "open",
});
// Send a message from the mailbox
await bird.email.mailboxes.messages.create(mailbox.id, {
to: ["alice@example.com"],
subject: "Your request has been received",
text: "We'll get back to you within one business day.",
});
A practical path through setup, implementation, and the choices that matter.
Read the field guide →Create your first address and follow a conversation.
Connect a signed event to a case and retrieve its files.
Use the supported agent interface.
Connect a domain your business controls.
Mailboxes are included in Email plans. Start with a generated inbox.ai address within your plan’s limits, then check the published mailbox, handle, storage and retention allowances for your workload.
Compare Email plans ↗Free workspaces use generated inbox.ai handles; check current plan limits.
Una clave API de prueba es tuya de inmediato. El acceso a producción se desbloquea cuando añades un método de pago y verificas un remitente.
Leer documentación