[Property Management integration]

Add postal proof to property management workflows

Use mailbox.bot around AppFolio-centered operations to send tenant notices with delivery proof, then route returned documents, forwarded scans, and mail photos back into the property-management record or case file.

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
Property teams that need certified or first-class tenant notices.
Proptech workflows that sit beside AppFolio data.
Agents that draft notices from property, tenant, lease, or maintenance context.
Triggers
Rent aging crosses a threshold.
Lease violation is approved for notice.
Move-out or security deposit deadline approaches.
[Workflow]
1

Agent or middleware receives property-management context.

2

Notice PDF is generated from tenant, property, lease, and deadline data.

3

mailbox.bot dry run validates the send.

4

Human approves legal or certified notices.

5

Delivery proof, returned paperwork, and inbound mail-photo evidence are stored back in the property management record or external case file.

Technical pattern
Use middleware, export, webhook, or workflow database records as the source if direct app APIs are not available.
Store tenant, property, lease, and notice IDs in metadata.
Use mailbox.bot webhooks to update the external proof trail.
Metadata to preserve
source=appfolio
property_id
tenant_id
lease_id
notice_type
deadline
case_id
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]=appfolio'
Agent prompts
"Draft a lease violation notice from this property management record and prepare a mailbox.bot certified dry run."
"When a tenant notice is approved, send it through mailbox.bot and attach delivery proof to the case record."