Direct mail API for schools
Direct mail API for schools: when a family submits an inquiry, your admissions webhook or nightly export makes one API call and a letter from the director of admissions is printed and mailed. Re-enrollment letters go out as batches of up to 1,000 from an SIS export, a recorded gift triggers a thank-you card, and open house posters and program flyers are ordered with the same API key.
Who builds this
The database manager or SIS admin at a private school, the web and data team behind a college admissions office, the enrollment-marketing agencies that serve independent schools, the central developer at a tutoring or test-prep franchise, and the companies that build admissions, student information and advancement software. They pull inquiries and decisions from the admissions system, household addresses from the SIS for re-enrollment, constituents and gifts from the advancement database for the annual fund and reunions, and order the posters, flyers and rack cards for open houses and college fairs.
Who to mail
| Who | Why paper works | What to send |
|---|---|---|
| Inquiries and applicants | Families compare several schools at once, and a signed letter from the director of admissions stands apart from the email sequence every school sends. | An 8.5x11 letter from the director of admissions after an inquiry, then a 5.5x8.5 open house or shadow-day invite. |
| Enrolled families before re-enrollment | Contracts and deposits come due on a fixed date, and a letter to the household reaches both guardians, not just the parent on the email list. | An 8.5x11 letter from the head of school before contracts open, and a 6x9 reminder to households that haven't signed by the deadline. |
| Alumni | Reunions and homecoming are planned around a class year, and a card with that year on it is the piece alumni keep. | A 5.5x8.5 reunion or homecoming invite by class year, and an 11x17 alumni news mailer folded to 8.5x11. |
| Donors: parents, grandparents and alumni | A thank-you from the head of school or president that arrives the week a gift is recorded is the part of giving donors remember. | A 6x9 thank-you card naming the fund (never the amount), and the annual fund appeal as an 11x17 folded mailer. |
| Event attendees | Open houses, info sessions, grandparents' day and campus visits are set months ahead, and families plan around a date they can see. | A 5.5x8.5 invite three weeks out with the event, date and campus. |
| Tutoring and test-prep families | Parents look for help around report cards, test dates and summer, so a card that lands then arrives when the decision is being made. | A 6x9 card before test season or summer to families whose last program ended, with the next session's start date. |
What to mail, and when
| When this happens | Mail this | Price |
|---|---|---|
| A family or student submits an inquiry or requests information | A letter from the director of admissions: the grade or program they asked about, visit dates and a direct phone line. (8.5x11 letter) | $0.95 |
| Three weeks before an open house, for inquiries who haven't applied | An open house invite with the date, the campus and the RSVP link. (5.5x8.5 postcard, Event invite) | $0.89 |
| An applicant is admitted | An admit mailer folded to 8.5x11: the welcome, the enrollment contract and deposit deadline, and what happens next. (11x17 folded mailer) | $1.39 |
| Re-enrollment contracts open in two weeks | A letter from the head of school to every current household with the contract window and the deposit date. (8.5x11 letter) | $0.95 |
| A household hasn't signed its contract a week before the deadline | A short reminder card with the deadline and the business office's number. (6x9 postcard) | $0.89 |
| A gift is recorded | A thank-you card from the head of school or president naming the fund, sent the week the gift arrives. (6x9 postcard) | $0.89 |
| Reunion season, for alumni in reunion class years | A reunion invite with the class year and the weekend's date. (5.5x8.5 postcard, Event invite) | $0.89 |
| A tutoring or test-prep student's program ends | A card before the next test date or summer session with the start date and how to enroll. (6x9 postcard) | $0.89 |
What to print
Printed and picked up free in Phoenix or shipped UPS Ground, ordered with POST /v1/prints.
| Piece | Used for | Price |
|---|---|---|
| 24x36 poster | Open house, homecoming and admissions-event posters for the entrance, the gym and the admissions office, from one. | $19.20 |
| 18x24 poster | Hallway posters for the musical, the book fair, spirit week and info nights. | $9.60 |
| 8.5x11 flyer | Program flyers for tutoring centers, after-school programs and summer camps, for libraries, community boards and feeder schools. | $0.53, from 100 |
| 4x9 rack card | Admissions and program cards for the front office, community centers and college fairs. | $0.26, from 100 |
| 5x7 table card | Table cards for open house stations, auctions and grandparents' day. | $0.29, from 100 |
| 3x3 vinyl sticker | Car stickers for families and class-year stickers for reunions and homecoming. | $0.64, from 50 |
Systems to connect
- Admissions and enrollment: Finalsite Enrollment (SchoolAdmin), Ravenna, Slate. Usually a scheduled export or a read-only API, run nightly. Finalsite Enrollment's External API is a paid add-on that accepts GET only, 100 records a page; Ravenna exports filtered application lists; Slate publishes any query as a web service that returns JSON. Pull new inquiries and decisions and mail what's new.
- Student information: Veracross or your SIS. A scheduled pull of households and parents before re-enrollment and reunions. Veracross API v3 uses an OAuth token and the scopes enabled on the OAuth application; other SIS platforms export households to CSV.
- Advancement: Raiser's Edge NXT or your donor database. A webhook or a nightly export of new gifts. Raiser's Edge NXT sends com.blackbaud.gift.add.v1 through the SKY API Webhook API with the gift and constituent IDs, and the constituent's address comes from the SKY API.
- HubSpot. Tutoring centers and admissions teams that run on HubSpot call Mailr from a workflow when a contact reaches a lifecycle stage.
- No software, or something else. Export a spreadsheet of families or alumni with addresses, one row each, and send it as a batch of up to 1,000.
Code: an inquiry letter, re-enrollment letters and a gift thank-you
// Call this from whatever you have: an admissions webhook, a nightly export or a website form.
// inquiry is your own record: id, parent name, student first name, program, mailing address.
import { readFileSync } from "node:fs";
const FRONT = readFileSync("mail/inquiry/front.html", "utf8"); // 8.5x11 letter with {{first_name}} and {{program}}
const BACK = readFileSync("mail/inquiry/back.html", "utf8");
export async function mailInquiryLetter(inquiry) {
const a = inquiry.address;
if (!a?.line1 || a.country !== "US") return null;
const res = await fetch("https://api.mailr.dev/v1/flats", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.MAILR_API_KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": `inquiry-letter-${inquiry.id}`, // a retry within 24 hours returns the first piece instead of creating a second
},
body: JSON.stringify({
size: "8.5x11",
front: FRONT,
back: BACK,
to: { name: inquiry.parentName.slice(0, 40), line1: a.line1, line2: a.line2 || undefined, city: a.city, state: a.state, zip: a.zip },
merge: { first_name: inquiry.parentFirstName.slice(0, 14), program: inquiry.program }, // "Grade 6" or "Summer STEM camp"
description: `Inquiry letter ${inquiry.id}`,
}),
});
const letter = await res.json();
if (!res.ok) throw new Error(letter.error.message);
return letter.id; // save it on the inquiry so the next run skips it
}What it costs
Open house invites to 1,500 inquiry families: 1,500 5.5x8.5 postcards at $0.89 each is $1,335.00 on pay as you go, or $1,035.00 on the Agency plan, printing and postage included. Inquiries for next fall who haven't applied, sent three weeks before the date as a batch of 1,000 and a batch of 500 with tmpl_event_invite. Test pieces are free. All prices.
Questions
Can Mailr mail tuition statements or financial aid letters?
Mailr's letters mail flat with no envelope, so anything with a balance, an award amount or a student's record on it should go by email, the parent portal or an envelope you mail yourself. Mail the inquiry letter, the re-enrollment reminder, the invite and the thank-you.
Is there an education or nonprofit postage rate?
No. Every sender pays the same price, printing and USPS postage included: $0.89 for a 5.5x8.5 or 6x9 card, $0.95 for an 8.5x11 letter and $1.39 for an 11x17 folded mailer pay as you go, or $0.69, $0.92 and $1.04 on the Agency plan.
How do we mail families with two households?
Send one piece per household your SIS lists for the student, each with its own Idempotency-Key. The same design goes to both homes in the same batch.
Can a college admissions office send its viewbook through Mailr?
Yes, as an 11x17 sheet folded to 8.5x11, up to 1,000 recipients per batch from one design. Bound booklets and envelopes aren't offered, so a multi-page viewbook needs a printer that binds them.
How does our code know a letter was mailed?
Each create returns an id. There are no webhooks yet, so poll GET /v1/flats/{id} or GET /v1/postcards/{id} for the status and its events, or list a batch's pieces with GET /v1/flats?batch={batch id}.
Do we get address updates for alumni who moved?
No. Mailr doesn't run NCOA or verify addresses. Keep alumni addresses current in your advancement database and send what's on file.