[Automation integration]

Use mailbox.bot as the postal action inside Zapier workflows

Use Zapier when you want the fastest no-code path from forms, CRMs, billing tools, or inbox apps into postal mail, then fan mailbox.bot delivery events or forwarded inbound mail artifacts back into the same Zap.

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
Fast no-code tests before a native integration exists.
Ops teams stitching together popular SaaS tools without maintaining their own worker or backend.
Simple outbound and inbound handoff flows where a Zap should react to a mailed event, forwarded document, or mail photo.
Triggers
New form response needs a mailed packet.
CRM field changes to Send Notice.
Invoice status or task label reaches a mail-required state.
[Workflow]
1

Zapier trigger collects source app data.

2

Formatter or AI step drafts the letter body or chooses a PDF.

3

Webhook or code step calls mailbox.bot with dry_run=true.

4

Approval step gates live sends when needed.

5

mailbox.bot webhook updates the source app, Zapier table, Slack channel, or task with mailed status, proof, or forwarded inbound artifacts.

Technical pattern
Use Zapier Webhooks or code steps to call POST /api/v1/mail.
Store the Zap run ID and source app IDs in metadata.
Use mailbox.bot sandbox keys while building the Zap and route webhook events back into Zapier Tables or follow-up actions.
Metadata to preserve
source=zapier
zap_id
zap_run_id
source_app
source_record_id
workflow
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]=zapier'
Agent prompts
"Build a Zapier workflow that sends certified mail through mailbox.bot when this Airtable status becomes Approved."
"Create a Zap that drafts a mailed notice from a form response, pauses for approval, then logs delivery proof."