> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bouncebox.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Mailboxes

> Create mailboxes, configure templates and delivery, and manage inbound addresses.

A mailbox is a dedicated inbound address plus rules for what to extract from email that arrives there and where to send the result. Most workspaces have one mailbox per source — invoices from one supplier, orders from another.

## Create a mailbox

Click **New mailbox**. BounceBox generates an address like `mail-7k2f@bouncebox.app` automatically. Only the local part (before the `@`) is editable — pick something memorable like `invoices-acme`. If the address is taken you'll see: *That address is already taken — pick a different local part.*

Starter allows 2 mailboxes; Pro and Custom are unlimited.

## Editor reference

| Field                                                  | What it does                                                                                                                       |
| ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| Output                                                 | Chips: `REPLY EMAIL` / `WEBHOOK` / `BOTH` — how the result is delivered.                                                           |
| Delivery mode                                          | `AUTOMATIC` delivers as soon as extraction finishes. `REVIEW FIRST` holds results in the inbox until you approve them.             |
| Template                                               | Chips: `INVOICE` / `ORDER` / `CUSTOM` — the extraction schema. See [Extraction templates](/configuration/extraction-templates).    |
| Instructions for the model                             | Free text, up to 4000 characters, that fine-tunes extraction for this mailbox — date formats, edge cases, house rules.             |
| Allowed senders (one per line — empty allows everyone) | Exact addresses (`billing@acmesupplies.com`) or domain suffixes (`@acmesupplies.com`). Email from anyone else is marked `SKIPPED`. |

### Webhook section

Shown when output is `WEBHOOK` or `BOTH`:

* **URL** — must be a public HTTPS endpoint. Localhost and private addresses are rejected.
* **Headers (JSON object)** — custom headers sent with every POST.
* **Body template** — optional custom payload using placeholders; leave empty for the canonical JSON payload.
* **Signing secret** — optional per-mailbox secret; defaults to your workspace secret. See [Webhooks](/configuration/webhooks).

### Reply email section

Shown when output is `REPLY EMAIL` or `BOTH`:

* **Reply to address** — where replies to the reply email go.
* **Subject template** — defaults to `Extracted: {{subject}}`.
* **Body template** — the reply body; the default includes the extracted data. See [Reply emails](/configuration/reply-emails).

Click **Save** — the page confirms with "Saved."

## Describe it with AI

Don't want to fill in fields? Open **Describe it with AI**, paste a plain-English description of the mailbox — "invoices from Acme Supplies, webhook to our ERP, always reply to accounts@" — and click **Parse config**. Review the generated settings and save.

## Pause vs delete

* **Pause** stops a mailbox from processing email while keeping its history. Pausing is done from the mobile app with the **Receiving** switch on a mailbox — see [Mobile app](/dashboard/mobile-app).
* **Delete** removes the mailbox permanently, along with every email it received. There is no undo — pause instead if you might come back.