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

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 happensMail thisPrice
Cloudbeds reservation/status_changed with status checked_outA 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 topicA 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 addressRates, 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.

PieceUsed forPrice
4x9 rack cardLobby and concierge rack cards: the restaurant, the pool, parking and things to do nearby.$0.26, from 100
4.25x11 rack cardTaller front-desk cards for room upgrades and the direct-booking rate.$0.30, from 100
5x7 table cardDesk cards in each room: Wi-Fi, breakfast hours and the book-direct code.$0.29, from 100
24x36 posterMeeting-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.

HOTELS

Build mail for hotels 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.