Restaurant direct mail and printed menus from one API
Restaurant direct mail with Mailr is a few API calls: a thank-you card after a guest's first delivery order, a win-back card when a regular goes quiet, and the takeout menus, window posters and table cards the dining room needs, ordered with the same key.
Who builds this
The in-house developer at a restaurant group who already pipes Toast or Square webhooks into a guest table. The agency running marketing for a dozen independents, reprinting every location's menu when prices change. The online-ordering, loyalty or catering SaaS that wants a "mail this guest" action next to email and SMS. All of them wire two things: an order or customer event that mails a postcard to a guest with a real delivery address, and a print job that sends the new menu PDF or poster file to press and ships it to each location.
What to mail, and when
| When this happens | Mail this | Price |
|---|---|---|
| Toast order_updated for a guest's first delivery order (fetch the order for deliveryInfo and the check's customer) | A thank-you card with 15% off the next order. (6x9 postcard, First-order thank you) | $0.89 |
| No order in 60 days from a guest your Toast or Square order history knows | A win-back card that names their usual dish, sent once a month as a batch. (6x11 postcard, Win-back) | $0.99 |
| Square customer.created or customer.updated with a birthday and an address on the profile | A birthday card in their birth month: dessert on the house that week. (4x6 postcard) | $0.85 |
| Every September: Tripleseat contacts whose holiday party or buyout closed last November or December | A card offering the same room and date again before the calendar fills. (6x11 postcard) | $0.99 |
| A new location opens: past delivery guests in the ZIP codes it serves | The full menu as a folded mailer, up to 1,000 guests per batch. (11x17 folded mailer) | $1.39 |
What restaurants print
Printed and picked up free in Phoenix or shipped UPS Ground, ordered with POST /v1/prints.
| Piece | Used for | Price |
|---|---|---|
| 11x17 tri-fold takeout menu | Takeout menus for bags and the host stand: 28 lb bond, folds to three panels, from 100. | $0.61, from 100 |
| 11x17 half-fold menu | Dine-in menus on 100 lb silk that fold to 8.5x11, reprinted whenever prices change. | $0.99, from 100 |
| 12x18 large menu | Large two-sided dinner or drink menus on 100 lb silk. | $1.04, from 100 |
| 8.5x11 menu | Single-page menus for prix fixe nights, brunch and daily specials. | $0.53, from 100 |
| 24x36 poster | Window and patio posters for a new season, a launch or a holiday menu, from one poster. | $19.20 |
| 12x18 poster or menu board | Counter menu boards and back-of-house posters, one side, from 100. | $0.88, from 100 |
| 5x7 table card | Table cards for happy hour, the loyalty sign-up or this week's specials. | $0.29, from 100 |
Systems to connect
- Toast. Subscribe to the orders webhook: eventType order_updated fires for new and changed orders, with the order in details.order. Guest names and delivery fields are left out, so GET /orders/v2/orders/{guid} with the Toast-Restaurant-External-ID header for checks[].customer and deliveryInfo (address1, city, state, zipCode).
- Square for Restaurants. order.created and order.updated for online orders (a delivery fulfillment's recipient has an address), customer.created and customer.updated for profiles. The Customer object carries address (address_line_1, locality, administrative_district_level_1, postal_code) and birthday.
- Tripleseat. Webhooks for private dining and catering: Lead Actions (create lead, convert lead), Event Actions (status changes from PROSPECT to TENTATIVE, DEFINITE, CLOSED or LOST) and Payment Actions, signed with the endpoint's signing key. The address is on the contact: GET /v1/contacts/{id}.json for addresses[].
- OpenTable. Reservations are built around email and phone. Export guests from Reporting, then Guests, then Export, and match them against addresses you already hold from delivery, catering or loyalty before mailing.
- Google Sheets. For agencies without API access to a client's POS: a sheet of guests with addresses, one row each, sent as one batch of up to 1,000.
Order takeout menus, mail a Toast thank-you, run the monthly win-back
# 500 tri-fold takeout menus (11x17 on 28 lb bond), shipped UPS Ground. Pay-as-you-go prices.
# POST the same body to /v1/prints/quote first to see the total without ordering.
curl https://api.mailr.dev/v1/prints \
-H "Authorization: Bearer $MAILR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: takeout-menu-2026-12-location-4" \
-d '{
"product": "menu",
"size": "11x17",
"fold": "tri",
"quantity": 500,
"file": "https://example.com/menus/takeout-december.pdf",
"delivery": {
"method": "ship",
"to": { "name": "Acme Kitchen", "line1": "2140 Sample Ave", "city": "Phoenix", "state": "AZ", "zip": "85016" }
},
"description": "Location 4 takeout menu, December prices"
}'
# 201 { "id": "prt_…", "object": "print", "status": "received", "quantity": 500,
# "unit_price": "0.61", "print_price": "305.00", "shipping": "26.50", "price": "331.50", … }What it costs
Win-back cards to 1,000 lapsed delivery guests: 1,000 6x11 postcards at $0.99 each is $990.00 on pay as you go, or $710.00 on the Agency plan, printing and postage included. Guests with a delivery address and no order in 60 days, sent as one POST /v1/batches with tmpl_winback and each guest's usual dish in last_product. Test pieces are free. All prices.
Questions
Where do restaurant guests' mailing addresses come from?
Delivery and catering orders (Toast deliveryInfo, a Square delivery fulfillment's recipient), loyalty or birthday-club sign-ups that ask for one, and private-event contacts in Tripleseat. Reservation tools are built around email and phone, so an OpenTable guest export usually needs matching against addresses you already hold.
Does Toast's orders webhook include the delivery address?
No. The order_updated message leaves out the guest's name, phone and delivery fields. GET /orders/v2/orders/{guid} with the Toast-Restaurant-External-ID header returns checks[].customer and deliveryInfo, which map straight onto Mailr's to object.
Can one job reprint menus for every location?
Yes. Send one POST /v1/prints per location with that location's PDF (or front and back HTML) and ship-to address, a description naming the location, and an Idempotency-Key per location and menu version so a retried job never prints twice. Menus start at 100 pieces, posters at one.
What do menus, posters and table cards cost?
Pay as you go: 8.5x11 menus $0.53 each, 11x17 half-fold menus $0.99, 11x17 tri-fold takeout menus $0.61, 12x18 two-sided menus $1.04, 5x7 table cards $0.29, posters $9.60 (18x24) and $19.20 (24x36). Pickup in Phoenix is free, UPS Ground to the lower 48 is added to the price, and POST /v1/prints/quote returns the total without ordering.
Can I build all of this without printing anything?
Yes. A mlr_test_ key is free and never prints. Test postcards walk from queued to processed_for_delivery in about 8 minutes and test print orders walk from received to completed, so the Toast handler and the menu job can run end to end before you add funds.