Hotel direct mail that starts at checkout
Hotel direct mail runs off the one moment every PMS records: checkout. Mailr mails a thank-you card with a book-direct code when Cloudbeds, Mews or apaleo checks a guest out, a return-visit card before the anniversary of the stay, and prints the rack cards that sit in the lobby.
Who builds this
The developer at a boutique hotel group with properties on Cloudbeds or Mews. The agency running direct-booking campaigns for independent hotels and inns. The guest-messaging or upsell app listed in a PMS marketplace that wants a mailed piece next to email and SMS. They subscribe to the checkout event, pull the guest's address from the guest or customer record, drop anyone outside the US, and send one card per stay with an Idempotency-Key built from the reservation id.
What to mail, and when
| When this happens | Mail this | Price |
|---|---|---|
| Cloudbeds reservation/status_changed with status checked_out | A thank-you card with a code for booking direct next time. (6x9 postcard) | $0.89 |
| A guest's third checked-out stay (count stays per guest across the Mews or Cloudbeds history) | A letter from the general manager with a standing perk for regulars. (8.5x11 letter, Welcome letter) | $0.95 |
| Eleven months after an apaleo checked-out event on the reservation topic | A return-visit card for the same week next year, with the direct rate. (6x11 postcard) | $0.99 |
| A seasonal resort or lodge reopens: every past guest with a US address | Rates, packages and the season's dates in a folded mailer, 1,000 guests per batch. (11x17 folded mailer) | $1.39 |
What hotels print
Printed and picked up free in Phoenix or shipped UPS Ground, ordered with POST /v1/prints.
| Piece | Used for | Price |
|---|---|---|
| 4x9 rack card | Lobby and concierge rack cards: the restaurant, the pool, parking and things to do nearby. | $0.26, from 100 |
| 4.25x11 rack card | Taller front-desk cards for room upgrades and the direct-booking rate. | $0.30, from 100 |
| 5x7 table card | Desk cards in each room: Wi-Fi, breakfast hours and the book-direct code. | $0.29, from 100 |
| 24x36 poster | Meeting-space and wedding welcome posters, from one. | $19.20 |
Systems to connect
- Cloudbeds. postWebhook with object reservation and action status_changed; the payload has propertyID, reservationID and status (checked_out at checkout). getGuest by reservationID returns firstName, lastName, address, address2, city, state and zip.
- Mews. General webhooks send ServiceOrderUpdated when a reservation changes; read it with reservations/getAll and mail when State is Processed (checked out). The guest's address comes from customers/getAll and the customer's address record.
- apaleo. A webhook subscription to the reservation topic; the checked-out event fires at checkout (canceled and set-to-no-show are separate events, so they never get a card).
- Tripleseat. For hotels selling weddings and groups: Guest Room Block Actions (create, update, delete) and Event Actions, with planners' postal addresses on contacts (GET /v1/contacts/{id}.json).
Mail at checkout, send the anniversary batch, restock lobby rack cards
// app/api/cloudbeds/route.js: subscribed with postWebhook to object "reservation", action "status_changed".
import { readFile } from "node:fs/promises";
export async function POST(req) {
const e = await req.json();
if (e.event !== "reservation/status_changed" || e.status !== "checked_out") return Response.json({ ok: true });
const url = `https://api.cloudbeds.com/api/v1.3/getGuest?propertyID=${e.propertyID}&reservationID=${e.reservationID}`;
const g = await (await fetch(url, { headers: { "x-api-key": process.env.CLOUDBEDS_API_KEY } })).json();
const guest = g.data;
// Mailr mails US addresses only: a two-letter state and a 5-digit or ZIP+4 code.
const us = /^[A-Z]{2}$/i.test(guest?.state ?? "") && /^\d{5}(-?\d{4})?$/.test(guest?.zip ?? "");
if (!g.success || !guest?.address || !us) return Response.json({ ok: true });
const res = await fetch("https://api.mailr.dev/v1/postcards", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.MAILR_API_KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": `stay-thanks-${e.reservationID}`,
},
body: JSON.stringify({
size: "6x9",
front: await readFile("mail/stay-thanks/front.html", "utf8"), // 9.25 x 6.25 in page with bleed
back: await readFile("mail/stay-thanks/back.html", "utf8"), // {{first_name}} and {{code}} tags
to: {
name: `${guest.firstName} ${guest.lastName}`,
line1: guest.address,
...(guest.address2 ? { line2: guest.address2 } : {}),
city: guest.city,
state: guest.state,
zip: guest.zip,
},
merge: { first_name: guest.firstName, code: `DIRECT-${e.reservationID.slice(-5)}` },
description: `Property ${e.propertyID}, reservation ${e.reservationID}`,
}),
});
const postcard = await res.json();
if (!res.ok) throw new Error(postcard.error.message);
await saveMailrId(e.reservationID, postcard.id);
return Response.json({ ok: true });
}What it costs
A month of post-stay thank-you cards: 800 6x9 postcards at $0.89 each is $712.00 on pay as you go, or $552.00 on the Agency plan, printing and postage included. One 6x9 card per checked-out stay with a US address, each sent from the checkout webhook; 800 is the month's count. Test pieces are free. All prices.
Questions
Which PMS event should trigger a post-stay card?
Checkout: Cloudbeds reservation/status_changed with status checked_out, apaleo's checked-out event on the reservation topic, or a Mews ServiceOrderUpdated whose reservation State is Processed. Mailing at checkout rather than at booking means canceled and no-show reservations never get a card.
Can I mail guests who live outside the US?
No. The to address must be a US address with a two-letter state and a 5-digit or ZIP+4 code; anything else returns a 422 that names the field. Filter international guests out before you send.
How does the third-stay letter use tmpl_welcome?
tmpl_welcome is an 8.5x11 flat that reads "Welcome to the club, {first_name}" with a short note from {founder_name} about getting {company} set up. Send first_name, the general manager's first name as founder_name, and a phrase like "your next stay" as company (24 characters at most).
What do lobby rack cards cost?
4x9 rack cards on 100 lb silk are $0.26 each pay as you go and 4.25x11 cards are $0.30, both from 100. 500 4x9 cards shipped UPS Ground comes to $147.75 ($130.00 printing, $17.75 shipping); pickup in Phoenix is free.