Direct mail for growth teams, with an API underneath. Read the docs →

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 happensMail thisPrice
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 knowsA 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 profileA 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 DecemberA 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 servesThe 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.

PieceUsed forPrice
11x17 tri-fold takeout menuTakeout menus for bags and the host stand: 28 lb bond, folds to three panels, from 100.$0.61, from 100
11x17 half-fold menuDine-in menus on 100 lb silk that fold to 8.5x11, reprinted whenever prices change.$0.99, from 100
12x18 large menuLarge two-sided dinner or drink menus on 100 lb silk.$1.04, from 100
8.5x11 menuSingle-page menus for prix fixe nights, brunch and daily specials.$0.53, from 100
24x36 posterWindow and patio posters for a new season, a launch or a holiday menu, from one poster.$19.20
12x18 poster or menu boardCounter menu boards and back-of-house posters, one side, from 100.$0.88, from 100
5x7 table cardTable 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.

RESTAURANTS

Build mail for restaurants today

Get a free test key, send a test postcard or print order, and watch it move through every status.

  • Postcards, flats and folded mailers
  • A proof before anything prints
  • Free test mode: nothing prints, nothing charges
  • A status for every piece

Download the template kit?

mailr-kit.zip · about 190 KB · 47 text files

Only HTML, JSON and Markdown files. No programs, scripts or macros, nothing that installs or runs.