Direct mail API for pet businesses
Direct mail API for pet businesses: when a new client's first visit is checked out, your booking webhook or nightly job makes one API call and a welcome card with the pet's name is printed and mailed. Pets past their usual grooming interval get a rebook card, past holiday boarders get the booking dates in a batch of up to 1,000, and front-desk rack cards and stickers are ordered with the same API key.
Who builds this
Groomers, boarding kennels, daycares, trainers and pet stores rarely have a developer, so this gets built by the marketing agencies that serve pet businesses, by the consultants who set up their booking software, by multi-location operators with an ops or data lead, by owners building their own tools with Claude Code or Cursor, and by pet-care software companies adding mail next to email and text. They connect first visits, check-outs and booking history to mail, run monthly rebook and win-back batches, and reorder the rack cards and stickers for the front desk.
Who to mail
| Who | Why paper works | What to send |
|---|---|---|
| New clients after the first visit | A card with the pet's name on it after the first groom or daycare day lands while the owner is deciding whether to come back. | A 6x9 welcome card with the pet's name, the groomer or trainer they saw, and how to book the next visit. |
| Clients due for grooming | Grooming runs on a cycle the groomer sets for each pet, and a card on the counter is a reminder the whole household sees. | A 4x6 rebook card when the pet's usual interval has passed and nothing is booked. |
| Boarding guests before the holidays | Holiday boarding fills early, and past boarders plan their trips weeks ahead. | A 5.5x8.5 card in early fall with the holiday booking dates and the deposit deadline. |
| Lapsed clients | A client who stopped booking may have just lost track, and a card that names their pet is hard to ignore. | A 6x11 win-back card with the pet's name and an offer on the next visit. |
| Clients whose vaccination records on file are about to expire | Boarding and daycare need current records before check-in, and a reminder to send the updated copy avoids a turned-away drop-off. | A 4x6 card 30 days before the record on file expires, asking them to upload the updated record before the next stay. |
| Training class graduates | A graduation card with the dog's name is something owners keep, and it's the moment to offer the next class. | A 6x9 card with the next class level and its start date. |
What to mail, and when
| When this happens | Mail this | Price |
|---|---|---|
| A new client's first visit is checked out | A welcome card with the pet's name, who they saw and how to book again. (6x9 postcard) | $0.89 |
| A pet's usual grooming interval has passed and nothing is booked | A rebook card with the pet's name and the booking link or number. (4x6 postcard) | $0.85 |
| Early fall, for clients who boarded over last year's holidays | A holiday boarding card with the dates that open and the deposit deadline. (5.5x8.5 postcard) | $0.89 |
| A vaccination record on file expires in 30 days | A reminder to send the updated record before the next boarding or daycare stay. (4x6 postcard) | $0.85 |
| A client hasn't booked in four months | A win-back card naming their pet, with an offer on the next visit, sent monthly as a batch. (6x11 postcard) | $0.99 |
| A dog finishes a training class | A graduation card with the next class and its start date. (6x9 postcard) | $0.89 |
| A client's referral books their first visit | A thank-you card with the credit on their next visit. (4x6 postcard) | $0.85 |
What to print
Printed and picked up free in Phoenix or shipped UPS Ground, ordered with POST /v1/prints.
| Piece | Used for | Price |
|---|---|---|
| 4x9 rack card | Service menus and price lists for the front desk, partner pet stores and community boards. | $0.26, from 100 |
| 4.25x11 rack card | Taller boarding and daycare info cards for new clients' welcome folders. | $0.30, from 100 |
| 5x7 table card | Front-desk signs with record requirements, the booking QR code and holiday hours. | $0.29, from 100 |
| 3x3 vinyl sticker | Logo stickers for crates, treat bags and take-home kits, cut square or circle. | $0.64, from 50 |
| 2x2 vinyl sticker | Small stickers for treat bags and graduation certificates. | $0.48, from 50 |
| 18x24 poster | Lobby and window posters for holiday boarding dates, new services and adoption events, from one. | $9.60 |
Systems to connect
- Grooming, boarding and daycare software: Gingr, PetExec, MoeGo, Revelation Pets. A webhook or a scheduled report. Gingr sends webhooks such as check_out (with the visit's invoice), owner_created and lead_created, signed with an HMAC-SHA256 of the webhook type, entity ID and entity type. MoeGo's API sends APPOINTMENT_FINISHED and CUSTOMER_CREATED events. PetExec's API lists owners and the grooming calendar by date range; Revelation Pets has a read-only API and a vaccine expiry report under Account Settings > Vaccines.
- Pet store POS: Square, Shopify POS, Lightspeed. Customer profiles with addresses and loyalty sign-ups, by webhook or a nightly sync; the retail page covers these in detail.
- Zapier or n8n. Connect a booking trigger, a new-client form or a spreadsheet to Mailr with one HTTP step.
- No software, or something else. Export a spreadsheet of clients and pets with addresses, one row each, and send it as a batch of up to 1,000.
Code: nightly rebook cards, holiday boarding cards and front-desk prints
// Nightly. duePets is your own query over booking history: pets past their usual interval with no future booking.
// Each row: petId, petName, lastVisitId, owner name and mailing address.
import { readFileSync } from "node:fs";
const FRONT = readFileSync("mail/rebook/front.html", "utf8"); // 4x6, uses {{pet_name}} and {{groomer}}
const BACK = readFileSync("mail/rebook/back.html", "utf8");
export async function mailRebookCards(duePets) {
for (const p of duePets) {
const a = p.owner.address;
if (!a?.line1) continue;
const res = await fetch("https://api.mailr.dev/v1/postcards", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.MAILR_API_KEY}`,
"Content-Type": "application/json",
// A retry within 24 hours returns the first card; markRebookMailed keeps later runs from mailing again.
"Idempotency-Key": `rebook-${p.petId}-${p.lastVisitId}`,
},
body: JSON.stringify({
size: "4x6",
front: FRONT,
back: BACK,
to: { name: p.owner.name.slice(0, 40), line1: a.line1, line2: a.line2 || undefined, city: a.city, state: a.state, zip: a.zip },
merge: { pet_name: p.petName, groomer: p.lastGroomer },
description: `Rebook ${p.petName} (${p.petId})`,
}),
});
const card = await res.json();
if (!res.ok) { console.error(p.petId, card.error?.message); continue; }
await markRebookMailed(p.lastVisitId, card.id); // your table: tomorrow's query leaves this pet out
}
}What it costs
Monthly rebook cards to 600 grooming clients: 600 4x6 postcards at $0.85 each is $510.00 on pay as you go, or $396.00 on the Agency plan, printing and postage included. Pets past their usual grooming interval with nothing booked, sent as one batch each month with the pet's name in a merge field. Test pieces are free. All prices.
Questions
What should the vaccination record reminder say?
Only the paperwork: which pet, the date the record on file expires, and how to send the updated copy before the next stay. Postcards mail without an envelope, so leave anything else off the card.
Where do pet owners' mailing addresses come from?
The new-client form, the online booking profile and the boarding or daycare agreement. If yours doesn't ask for a mailing address, add it there; Mailr can only mail clients who have one on file.
What does a monthly rebook program cost?
A 4x6 card is $0.85 pay as you go or $0.66 on the Agency plan, printing and postage included, so 600 rebook cards a month is $510 or $396. Rack cards for the front desk are $0.26 each from 100.
Can each location send its own cards?
Yes. Put the location's return address in from on each request, or save one default in Settings, and name the location in description so you can split pieces and costs by shop.
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 nightly rebook job can run against a test client before you add funds.