# Send Personalized Postcards with Visual Creative via API

> Before-and-after photos, property renders, service showcases, and promotional offers — designed per recipient, printed as postcards, and mailed via API with delivery tracking.

## How it works

1. System identifies recipients from permits, property data, CRM events, or geographic targeting
2. Agent or design system renders unique creative per recipient — property photos, before/after images, personalized copy
3. Submit the final postcard design as a PDF to mailbox.bot
4. We print it as a high-quality postcard, apply postage, and mail it. Per-piece tracking included.

## Why visual postcards beat generic mailers

- Postcards are seen immediately — no envelope to open
- Before-and-after photos of similar projects prove capability
- AI-rendered mockups showing the recipient's own property with proposed work get 3-5x higher response
- Each piece can have completely different creative, not just mail-merged text

## Industries that use this

- **Home services**: roofing, solar, windows, HVAC, landscaping, painting — permit-triggered with property photos
- **Restaurants & retail**: seasonal promotions, new menu items, grand openings with location-specific creative
- **Real estate agents**: just-listed and just-sold postcards with property photos to farm areas
- **Auto dealers**: service reminders and promotional offers with vehicle-specific creative
- **Dental & medical**: appointment reminders and new patient offers

## Code example

```bash
curl -X POST https://mailbox.bot/api/v1/mail \
  -H "Authorization: Bearer sk_agent_live_..." \
  -F 'document=@postcard-front-back.pdf' \
  -F 'recipient_name=Homeowner' \
  -F 'recipient_line1=123 Elm St' \
  -F 'recipient_city=Denver' \
  -F 'recipient_state=CO' \
  -F 'recipient_zip=80202' \
  -F 'mail_class=first_class'
```

## Cost

- Standard postcard: $0.30 printing + postcard postage
- Color printing included in postcard format
- No monthly fee for outbound-only

## Best for

- Home services companies using permit data and property photos for outreach
- Restaurants and retail sending visual promotional postcards to targeted areas
- Any business where the visual is the message and per-recipient personalization drives response

## Related

- HTML page: https://mailbox.bot/use-cases/postcard-campaigns
- Home services workflow: https://mailbox.bot/workflows/home-services
- AI agent mailing: https://mailbox.bot/use-cases/ai-agent-mailing-address