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

Direct mail API for cleaning companies

Direct mail API for cleaning companies: a week after a one-time or deep clean is marked complete, your nightly job makes one API call and a card with the recurring rate is printed and mailed. A new client's first clean triggers a review card, anniversaries go out monthly as a batch, and "cleaned by" yard signs and rack cards are ordered with the same API key.

Who builds this

Residential maid services and commercial janitorial companies rarely have a developer, so this gets built by the marketing agencies that serve home-service and cleaning businesses, by the consultants who set up their scheduling software and automations, by multi-location franchise operators with an ops lead, by owners building their own tools with Claude Code or Cursor, and by cleaning-software companies adding mail next to email and text. They connect completed jobs, quotes and client records to mail, run monthly anniversary and win-back batches, and reorder the yard signs and leave-behind cards the teams carry.

Who to mail

WhoWhy paper worksWhat to send
One-time and deep-clean customersThe week after a deep clean, the house still looks the way they want it to, and a card with the recurring rate makes the next step easy.A 6x9 card a week after the clean with the weekly, biweekly or monthly rate and an offer on the first recurring visit.
Recurring clients on their anniversaryRecurring clients rarely hear from the owner unless something goes wrong, and a thank-you on their one-year mark is a reason to stay.A 6x9 card signed by the owner, naming the team that cleans their home.
Move-in and move-out customersA move has a fixed date, and a new home is a fresh start for regular cleaning.A 6x9 card to the new address after a move-in clean, offering recurring service there.
Commercial accountsOffice and property managers review cleaning contracts on a schedule, and a letter on their desk before renewal is a reminder of the service they get.An 8.5x11 letter to the decision-maker before the contract renews, and a 6x9 card when you add a service such as floor care or windows.
Lapsed clientsClients who paused for budget or a move often mean to come back, and a card with a return offer gives them a date.A 6x11 card a few months after the last visit with a return offer.
Neighbors of current clientsA clean house next door is the best advertisement, and a card that says your team already cleans on their street reaches the people who can see it.A 6x9 card to homes near current clients from a list you buy, and a "cleaned by" yard sign at the client's home when they agree.

What to mail, and when

When this happensMail thisPrice
A one-time, deep or move-out clean is completedA card a week later with the recurring rate and an offer on the first recurring visit. (6x9 postcard)$0.89
A new client's first clean is completedA review card naming the clean, with a short link to your review page. (4x6 postcard, Review request)$0.85
A quote is sent and still not booked after a weekA quote follow-up card with the service, the price quoted and the number to book. (6x9 postcard)$0.89
A move-in clean is booked at a new addressA welcome-home card offering recurring service at the new address. (6x9 postcard)$0.89
A recurring client reaches one yearAn anniversary card from the owner naming their team. (6x9 postcard)$0.89
A commercial contract renews in 60 daysA letter to the decision-maker with the year's service, any changes and who to call. (8.5x11 letter)$0.95
A recurring client cancels or hasn't had a clean in 60 daysA win-back card with a return offer, sent monthly as a batch. (6x11 postcard)$0.99
Spring and the holidays, for one-time clients from the past yearA seasonal deep-clean card with the dates that are filling up. (6x9 postcard)$0.89

What to print

Printed and picked up free in Phoenix or shipped UPS Ground, ordered with POST /v1/prints.

PieceUsed forPrice
18x24 yard sign"Cleaned by" signs the team places at a client's home on cleaning day when the client agrees, with H-stakes if you ask for them.$4.75–$7.00, from 10
4x9 rack cardService and pricing cards left on the counter after a clean, and for realtors' and property managers' offices.$0.26, from 100
4.25x11 rack cardTaller leave-behind cards for move-out cleans and new clients' welcome folders.$0.30, from 100
3x3 vinyl stickerLogo stickers with the booking number for supply caddies, binders and leave-behind kits, cut square or circle.$0.64, from 50
8.5x11 flyerFlyers for community boards and property-management offices.$0.53, from 100

Systems to connect

  • Field service and scheduling: Jobber, Housecall Pro. Webhooks. Jobber's (set on your app in the Developer Center) include VISIT_COMPLETE, JOB_CLOSED, QUOTE_SENT and CLIENT_CREATE, signed in X-Jobber-Hmac-SHA256; query GraphQL for the property address. Housecall Pro's webhooks are on the MAX plan, turned on in its Webhooks app card, with job events such as job scheduled and job paid.
  • Cleaning booking software: ZenMaid, Launch27, BookingKoala. Usually through Zapier. ZenMaid's Zapier triggers include appointment status updates, and BookingKoala's include New Booking and Booking Completed; Launch27 connects the same way. Send the trigger's address fields to Mailr in one HTTP step.
  • GoHighLevel. Agencies that run cleaning companies' marketing on HighLevel call Mailr from a workflow when a contact reaches a pipeline stage.
  • Zapier or n8n. Connect a booking trigger, a quote form or a spreadsheet to Mailr with one HTTP step.
  • No software, or something else. Export a spreadsheet of clients with addresses, one row each, and send it as a batch of up to 1,000.

Code: a recurring offer after a one-time clean, anniversary cards and yard signs

// Call this from whatever you have: a job-completed webhook, a Zapier step or a nightly job.
// job is your own record of the finished clean: id, type, client name and service address.
import { readFileSync } from "node:fs";

const FRONT = readFileSync("mail/recurring-offer/front.html", "utf8"); // 6x9, uses {{first_name}} and {{clean}}
const BACK = readFileSync("mail/recurring-offer/back.html", "utf8");

export async function mailRecurringOffer(job) {
  if (!["one_time", "deep", "move_out"].includes(job.type) || job.client.hasRecurring) return null;
  const a = job.serviceAddress;

  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": `recurring-offer-${job.id}`, // a retry within 24 hours returns the first piece instead of creating a second
    },
    body: JSON.stringify({
      size: "6x9",
      front: FRONT,
      back: BACK,
      to: { name: job.client.name.slice(0, 40), line1: a.line1, line2: a.line2 || undefined, city: a.city, state: a.state, zip: a.zip },
      merge: { first_name: job.client.firstName.slice(0, 14), clean: job.typeLabel }, // "deep clean"
      description: `Recurring offer after job ${job.id}`,
    }),
  });
  const card = await res.json();
  if (!res.ok) throw new Error(card.error.message);
  return card.id; // save it on the job so a later run skips it
}

What it costs

Recurring-service offers to 400 one-time clients: 400 6x9 postcards at $0.89 each is $356.00 on pay as you go, or $276.00 on the Agency plan, printing and postage included. Every one-time, deep or move-out clean from the past quarter that didn't book again, sent as one batch with the client's first name and the clean they had in merge fields. Test pieces are free. All prices.

Questions

Can we mail every house on a client's street?

Mailr mails the addresses you send. It doesn't sell lists or offer every-door saturation mail, so buy a residential list for those streets or ZIP codes and send it in batches of up to 1,000.

Which address do we mail for commercial accounts?

Mail the decision-maker, which is often the billing or management office rather than the site you clean. Keep both on the account and send the renewal letter to the one that signs the contract.

Can the card show the client's price?

An offer or a recurring rate is fine on a postcard. Balances, invoices and card details belong in email or the client portal, since postcards mail without an envelope.

What do yard signs and rack cards cost?

Pay as you go: 18x24 yard signs printed both sides are $11.20 each for 10 to 100 ($9.60 for 101 to 250), plus $1.20 a stake; 4x9 rack cards are $0.26 and 4.25x11 cards $0.30 from 100. Pickup in Phoenix is free; UPS Ground to the lower 48 is priced by destination.

Can we try it without mailing real clients?

Yes. A mlr_test_ key is free and never prints. Test pieces move through every status on their own, so the job-completed handler can run end to end before you add funds.

CLEANING SERVICES

Build mail for cleaning services 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 310 KB · 65 text files

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