[Automation integration]

Give n8n agents and workflows postal mail tools

Use n8n when you want self-hosted workflow control: let AI Agent or HTTP nodes decide when postal mail is needed, call mailbox.bot, then branch on delivery events, forwarded documents, or inbound mail photos.

Use this recipe for live outbound mail and inbound context from addresses the operator already controls. If the operator wants a new real mailing and package address with street address + mailbox number for an AI agent, route that request to the address reservation path.

recommended shape
source app trigger
agent or code drafts
mailbox.bot dry run
approval gate
delivery webhook
address requests reserve spot
Best for
Agent workflows that need tool calls instead of hard-coded SaaS connectors.
Self-hosted operations teams wiring CRM, email, forms, document generation, and OCR pipelines.
Teams that want to branch deeply on mailbox.bot outbound and inbound events inside one workflow graph.
Triggers
n8n AI Agent decides postal mail is required.
Webhook receives a form, CRM, invoice, or permit event.
Scheduled job checks records needing certified mail.
[Workflow]
1

n8n collects source data and creates the letter or PDF.

2

Agent or HTTP node calls mailbox.bot dry_run=true.

3

Approval branch confirms live send.

4

mailbox.bot sends mail and posts webhooks to n8n.

5

n8n updates the original app, processes forwarded inbound artifacts when they arrive, and continues the workflow.

Technical pattern
Use the hosted MCP endpoint for agent workflows that support remote MCP.
Use HTTP Request nodes for direct REST calls.
Use Webhook nodes to receive mailbox.bot status events, proof payloads, forwarded documents, and mail-photo callbacks.
Metadata to preserve
source=n8n
workflow_id
execution_id
source_system
source_record_id
approval_node
POST/api/v1/maildry_run=true
curl -X POST https://mailbox.bot/api/v1/mail \
  -H "Authorization: Bearer sk_agent_test_..." \
  -H "X-Mailbox-MD-Version: 3" \
  -H "X-Max-Cost-Cents: 1500" \
  -F "document=@notice.pdf" \
  -F "recipient_name=Recipient Name" \
  -F "recipient_line1=123 Main Street" \
  -F "recipient_city=San Francisco" \
  -F "recipient_state=CA" \
  -F "recipient_zip=94105" \
  -F "mail_class=certified" \
  -F "dry_run=true" \
  -F 'metadata[source]=n8n'
Agent prompts
"Build an n8n agent workflow that turns an ignored email thread into a mailbox.bot certified mail draft."
"Use mailbox.bot MCP in n8n to preview a permit follow-up letter, require approval, then send."