Skip to main content
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 the + button in the header to open the New mailbox editor. Nothing is created yet — the editor is a draft until you save. The editor opens with Set up with AI at the top, followed by the Delivery and Extraction schema sections — the Webhook and Reply email sections appear only when those outputs are selected. The Address field takes the local part only — the @in.bouncebox.app domain sits next to it and is fixed. Leave it empty and the address is generated on save; the copy button copies the full address. Forward emails to that address for processing — the forwarding guide covers Gmail, filters, and Zapier. Click Save. If you left the address empty, BounceBox generates one like mail-7k2f@in.bouncebox.app; otherwise your chosen local part is used. If you leave the editor with unsaved changes, you’re asked to confirm discarding them first. Starter allows 2 mailboxes; Pro and Custom are unlimited. During the 14-day Pro trial the header shows <plan> trial instead of <plan> plan, and Pro limits apply. At the limit, the + button is replaced by an Upgrade for more mailboxes link. The same flow applies in the mobile app: tap + on the Mailboxes tab, configure the editor, and tap Save.

​
Set up with AI

Don’t want to fill in fields yourself? In Set up with AI, tell AI what the mailbox should do, in your own words. For example: “Call it Customer orders, only accept mail from @greenleaf.com, pull out the customer, items and quantities, and email them to orders@mycompany.com once a day.” AI can set:
  • Mailbox name, when you name it (“call it Supplier invoices”).
  • Use case: invoices, orders, custom details, or store only.
  • Accept mail from: the email addresses or @domains allowed to send to the mailbox.
  • Details to pull out, which switches the mailbox to a custom template.
  • Extra instructions for reading your emails, such as “dates are DD/MM”. These are added to the mailbox’s instructions; they don’t replace them.
  • Where results go: email, webhook, or both, plus who receives them and how often.
Click Fill in settings. AI shows what it understood and fills in the editor fields below. Anything you didn’t mention stays as it is. If you asked for something BounceBox can’t do exactly, it says so and picks the closest option. Check the settings, then click Save.

​
Editor reference

​
Delivery

​
Extraction schema

​
Webhook section

Shown when the Webhook switch is on:
  • URL — must be a public HTTPS URL. Plain HTTP, localhost, and private network addresses are rejected.
  • Authentication — NONE, BEARER TOKEN, or CUSTOM HEADER; the choice writes the matching entry into the request headers for you.
  • Advanced — collapsed block holding the raw Headers (JSON object), the optional Body template, and the Signing secret (empty uses the built-in default; it signs every request as sha256=<hmac> in X-BounceBox-Signature). See Webhooks.
  • Last delivery — below Advanced, the most recent webhook attempt on this mailbox: status, last HTTP code, time, attempt count, and the last error when it failed.
  • Verify signatures — a collapsed block with a copy-ready Node snippet that recomputes X-BounceBox-Signature from the raw body using your saved secret.

​
Reply email section

Shown when the Reply email switch is on:
  • 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.
Click Save on a new mailbox or Save changes on an existing one — the page confirms with “Saved.”

​
Pause vs delete

  • Pause stops a mailbox from processing email while keeping its history. Pausing is done from the mobile app with the Active switch on a mailbox — see Mobile app.
  • Delete removes the mailbox permanently, along with every email it received. Tap Delete mailbox in the mailbox editor (web and mobile app), then confirm in the Delete mailbox? dialog. There is no undo — pause instead if you might come back.