[Automation integration]

Use mailbox.bot as the postal action inside Zapier workflows

Use Zapier to trigger postal mail from thousands of apps, then route mailbox.bot delivery events back into the same automation path.

recommended shape
source app trigger
agent or code drafts
mailbox.bot dry run
approval gate
delivery webhook
Best for
Fast no-code tests before a native integration exists.
Triggering letters from CRMs, forms, sheets, task apps, or billing systems.
Teams that want postal mail in a Zap without building a custom backend first.
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.

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.
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."