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

recommended shape

form, CRM or billing trigger

formatter or AI step drafts

webhook step posts dry_run=true

approval step before live send

mailbox.bot event back into the Zap

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

Webhooks by Zapier (Custom Request, multipart/form-data) posts to POST /api/v1/mail; Paths gate the live send behind an approval step.

A Catch Hook trigger receives mail status events and writes them to Zapier Tables or the source app.

Store zap_id and zap_run_id in metadata so the Zap that receives the event can update the row it created.

Build with a sandbox key and dry_run=true until the Zap is stable, then switch the key.

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: <version>" \
  -H "X-Max-Cost-Cents: 1500" \
  -F "document=@form-response-letter.pdf" \
  -F "recipient_name=<recipient>" \
  -F "recipient_line1=<street>" \
  -F "recipient_city=<city>" \
  -F "recipient_state=<state>" \
  -F "recipient_zip=<zip>" \
  -F "mail_class=first_class" \
  -F "dry_run=true" \
  -F 'metadata[zap_id]=<zap_id>' \
  -F 'metadata[zap_run_id]=<zap_run_id>' \
  -F 'metadata[source_app]=<source_app>' \
  -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."