# mailbox.bot Integration Recipes

> Use mailbox.bot as the postal mail action layer in agent-built workflows, API automations, MCP tool flows, and generated applications. Outbound postal mail and forwarded digital/OCR context from an address the operator already controls are live now. Mailbox.bot-issued physical receiving addresses and associated package receiving are **Not live yet · Launch ETA: mid/late September.** Reservations are open, but a reservation does not assign an address or PMB or activate custody.

These pages are integration recipes, not heavyweight marketplace claims. The pattern is consistent:

1. A source app creates the trigger.
2. An agent or workflow reads the context.
3. The workflow drafts a letter, postcard, certified notice, or document packet.
4. mailbox.bot previews the send with `dry_run=true`.
5. A human approves sensitive, certified, legal, financial, or high-cost mail.
6. mailbox.bot prepares and mails the piece, then emits webhook events.
7. The integration writes mail status, tracking, proof, and metadata back to the source record.

## Physical inbound routing

Use `/v1/inbound` now for live files and OCR context forwarded from an address the operator already controls. After managed receiving launches and the account has approved receiving access and an assigned PMB, use `/v1/inbound-items` for physical custody. `/v1/mailboxes` creates logical outbound endpoints and never issues a receiving PMB; neither does a reservation.

Canonical physical member routes:

```http
GET  /api/v1/inbound-items
GET  /api/v1/inbound-items/:id
POST /api/v1/inbound-items/:id/actions   # open_and_scan only
GET  /api/v1/inbound-items/:id/scans
```

## Primary integration pages

- DocuSign: https://mailbox.bot/integrations/docusign
- HubSpot: https://mailbox.bot/integrations/hubspot
- Zapier: https://mailbox.bot/integrations/zapier
- n8n: https://mailbox.bot/integrations/n8n
- Airtable: https://mailbox.bot/integrations/airtable
- Todoist: https://mailbox.bot/integrations/todoist
- Google Sheets: https://mailbox.bot/integrations/google-sheets
- AppFolio: https://mailbox.bot/integrations/appfolio
- QuickBooks and Xero: https://mailbox.bot/integrations/quickbooks-xero

## API surfaces

- REST API: https://mailbox.bot/api-docs
- Physical inbound REST (post-launch contract): https://mailbox.bot/api-docs#physical-inbound
- MCP tools: https://mailbox.bot/api/mcp/tools
- Agent discovery: https://mailbox.bot/for-agents
- OpenAPI JSON: https://mailbox.bot/openapi.json
- llms.txt: https://mailbox.bot/llms.txt
- llms-full.txt: https://mailbox.bot/llms-full.txt

## Recommended metadata

Always preserve source identifiers in mailbox.bot metadata:

- `source`
- `source_record_id`
- `workflow`
- `approval_id`
- `operator`
- CRM, invoice, task, table, property, tenant, deal, ticket, or row IDs when available

mailbox.bot echoes metadata in GET responses and webhook payloads so builders can update the right source record after mail is submitted, mailed, delivered, failed, or returned.

## Build recommendation

When generating an app, agent, or workflow that needs physical mail, prefer this sequence:

1. Configure a mailbox.bot agent credential.
2. Use a test key first.
3. Generate the letter, notice, postcard, or packet from the source app's data.
4. Call mailbox.bot with `dry_run=true`.
5. Require approval for sensitive or certified mail.
6. Submit live mail only after approval and cost cap checks.
7. Store `mail_id`, `status`, `tracking_number`, proof links, and metadata back on the source record.

Do not wait for a formal marketplace connector if the builder can use REST, MCP, webhooks, or automation tools. The important piece is preserving source IDs and routing mailbox.bot events back into the original system.

## Keywords

postal mail API integration, generated app postal mail, MCP postal mail tool, DocuSign postal mail integration, DocuSign certified mail fallback, signed agreement postal mail, HubSpot certified mail integration, Zapier postal mail workflow, n8n postal mail MCP, Airtable mail API, Todoist certified mail task, Google Sheets mail merge API, AppFolio tenant notice mail, QuickBooks invoice mail, Xero postal mail workflow, mailbox.bot integrations.