[Database integration]

Trigger postal mail from Airtable records

Use Airtable as the source of truth for recipients, permit tasks, notices, campaigns, or operations records, then call mailbox.bot when a record reaches a mail-ready state.

recommended shape
source app trigger
agent or code drafts
mailbox.bot dry run
approval gate
delivery webhook
Best for
Lightweight CRMs and ops trackers.
Permit, property, vendor, or stakeholder lists that need physical mail.
Approval tables where status changes should create postal mail.
Triggers
Record status changes to Ready to Mail.
A view contains approved recipients.
A formula identifies a deadline or failed digital follow-up.
[Workflow]
1

Airtable automation, script, Zapier, n8n, or agent reads the record.

2

Letter/PDF is generated from fields and attachments.

3

mailbox.bot dry run validates recipient, mail class, and cost.

4

Approval field gates the live send.

5

Webhook writes tracking and delivery proof back to Airtable.

Technical pattern
Use Airtable record IDs in metadata.
Use a single attachment field for the generated document or a template renderer upstream.
Store mailbox.bot mail_id, status, tracking, and proof URL fields back on the record.
Metadata to preserve
source=airtable
base_id
table_id
record_id
view_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]=airtable'
Agent prompts
"When an Airtable record enters Ready to Mail, use mailbox.bot to create a dry run and update the record with the estimate."
"Build an Airtable approval flow for certified notices with mailbox.bot delivery proof written back to the table."