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

Direct mail API for churches

Direct mail API for churches: when a first-time guest fills out a connection card, your webhook handler or nightly export makes one API call and the pastor's welcome letter is printed and mailed that week. A first gift triggers a thank-you card, the Christmas and Easter invites go out as batches of up to 1,000 from a household export, and lobby posters and rack cards are ordered with the same API key. Test keys are free and never print.

Who builds this

Most churches have no developer on staff. This gets built by the communications director or the admin who runs the church management system, by a volunteer developer in the congregation, by the agencies and freelancers who run websites and outreach for several churches, and by church software companies adding a "mail this person" step next to email and text. They connect new guests, gifts, registrations and attendance to mail, pull seasonal invite lists from the household file, and order the posters, flyers, rack cards and stickers for the lobby, the welcome desk and youth events.

Who to mail

WhoWhy paper worksWhat to send
First-time guestsA letter from the pastor that arrives the week after a first visit is a follow-up the whole household sees, not one more email in one person's inbox.An 8.5x11 letter signed by the lead pastor, with service times, how kids' check-in works and a name to ask for next Sunday.
Givers on the anniversary of their first giftA year of giving is a moment the church rarely marks, and a card that names the ministry they support says thank you without asking for more.A 6x9 card from the pastor on the anniversary of their first gift, naming the fund, never the amount.
Lapsed attendersSomeone who drifted away often mutes the group text but keeps a card from a person they know on the counter.A 6x9 "we've missed you" card from their campus pastor or group leader, with the next sermon series and service times.
Event and class registrantsVBS, camp and membership-class families plan weeks ahead, and a card with the date is easy to put on the fridge.A 5.5x8.5 card three weeks out with the event, the date and what to bring.
VolunteersVolunteers hear from the church when a slot needs filling; a thank-you on paper after a busy season is rarer and remembered.A 4x6 thank-you after VBS, Christmas services or a serving season, signed by the ministry lead.
Christmas and Easter guestsThese are the weekends people are most open to an invitation, and a mailed card is something a member can hand to a neighbor and a guest family can keep.A 5.5x8.5 invite with service times by campus, to every household on file and last year's holiday guests.

What to mail, and when

When this happensMail thisPrice
A first-time guest fills out a connection card or a plan-a-visit formA welcome letter from the lead pastor the same week: service times, kids' check-in and who to ask for next Sunday. (8.5x11 letter)$0.95
Someone gives for the first timeA thank-you card from the pastor naming the fund the gift went to. No amount on the card. (6x9 postcard)$0.89
A giver reaches one year since their first giftAn anniversary card thanking them for a year of giving and naming one thing it made possible. (6x9 postcard)$0.89
A family hasn't attended or checked in for eight weeksA "we've missed you" card from the children's or campus pastor with the next series and service times. (6x9 postcard)$0.89
Six weeks before Christmas and Easter, for every household on file and last year's holiday guestsAn invite with the services and times big enough to go on the fridge, in batches of up to 1,000. (5.5x8.5 postcard, Event invite)$0.89
Someone registers for VBS, camp or a membership classAn event card three weeks out with the date, the drop-off time and what to bring. (5.5x8.5 postcard, Event invite)$0.89
A volunteer finishes a serving seasonA thank-you card signed by the ministry lead. (4x6 postcard)$0.85
Year-end, for every giving householdA year-end ministry report folded to 8.5x11: what giving funded this year, stories from missions and kids' ministry, next year's plans. No personal amounts. (11x17 folded mailer)$1.39

What to print

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

PieceUsed forPrice
24x36 posterLobby and entrance posters for a new sermon series, Easter or Christmas services, from one poster.$19.20
18x24 posterHallway and kids' wing posters for VBS, camp, youth nights and serve days.$9.60
8.5x11 flyerOutreach and event flyers for community boards, partner businesses, schools and the welcome desk.$0.53, from 100
4x9 rack cardWelcome-desk cards: next steps, groups, giving by text and the church app.$0.26, from 100
3x3 vinyl stickerYouth group, camp and VBS stickers, and car stickers with the church logo, cut square or circle.$0.64, from 50

Systems to connect

  • Church management: Planning Center, Breeze, Pushpay/ChurchStaq, Tithe.ly. A webhook or a scheduled export. Planning Center sends webhooks (people.v2.events.person.created for a new person, with addresses at /people/v2/people/{id}/addresses). Breeze has no webhooks but a REST API with an Api-Key header for people, attendance and form entries, so run it nightly. Tithe.ly exports people to CSV with the address fields you pick. Map each person's address to Mailr's to.
  • Online giving: Planning Center Giving, Pushpay, Tithe.ly. Planning Center Giving sends giving.v2.events.donation.created and Pushpay sends payment_created; Pushpay doesn't retry failed deliveries, so add a nightly check by date. Giving records carry the giver, not always a mailing address, so look the person up in your church management system. Tithe.ly exports transactions by date range.
  • Events, registrations and check-in. Registrations, VBS signups and kids' check-in usually live in the same church management system. Pull new signups and each family's last check-in date nightly, and mail from that list.
  • Zapier or n8n. Connect a website form or any of the tools above to Mailr with one HTTP step, without writing a server.
  • No software, or something else. Export a spreadsheet of households with addresses, one row each, and send it as a batch of up to 1,000.

Code: a guest welcome letter, Christmas invites and Easter posters

// Call this from whatever you have: a church management webhook, a form handler or a nightly job.
// guest is your own record of the person: id, first and last name, and a mailing address.
import { readFileSync } from "node:fs";

const FRONT = readFileSync("mail/welcome/front.html", "utf8"); // 8.5x11 letter with {{first_name}} and {{pastor}}
const BACK = readFileSync("mail/welcome/back.html", "utf8");

export async function mailGuestWelcome(guest) {
  if (!guest.address?.line1) return null; // no mailing address on the connection card

  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": `guest-welcome-${guest.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: `${guest.firstName} ${guest.lastName}`.slice(0, 40),
        line1: guest.address.line1,
        line2: guest.address.line2 || undefined,
        city: guest.address.city,
        state: guest.address.state, // two-letter code
        zip: guest.address.zip,
      },
      merge: { first_name: guest.firstName.slice(0, 14), pastor: "Pastor Dana" },
      description: `Guest welcome ${guest.id}`,
      // "from" is left out: Mailr uses the church's return address saved in Settings.
    }),
  });
  const letter = await res.json();
  if (!res.ok) throw new Error(letter.error.message);
  return letter.id; // save it on the guest record and skip guests that have one
}

What it costs

Christmas Eve invites to 3,000 households: 3,000 5.5x8.5 postcards at $0.89 each is $2,670.00 on pay as you go, or $2,070.00 on the Agency plan, printing and postage included. Every household on file plus last year's Christmas guests, sent as three batches of 1,000 with tmpl_event_invite and each campus's service times in event_date. Test pieces are free. All prices.

Questions

Is there a church or nonprofit postage rate?

No. Mailr charges every sender the same price, printing and USPS postage included: a 5.5x8.5 or 6x9 card is $0.89, an 8.5x11 letter $0.95 and an 11x17 folded mailer $1.39 pay as you go, or $0.69, $0.92 and $1.04 on the Agency plan ($149 a month).

Can we mail giving statements with Mailr?

Not the statement itself. Letters and postcards mail flat with no envelope, so anything showing a gift amount belongs in email or an envelope you mail yourself. Use Mailr for the thank-you card, the anniversary card and the year-end ministry report.

Where do first-time guests' addresses come from?

The connection card (paper or digital), the plan-a-visit form on your website, a parent filling in the household at first check-in, event registrations and giving profiles. If your check-in flow doesn't ask for an address, add it to the connection card, since a guest without one can't be mailed.

Can a church without a developer set this up?

Yes. Export households from your church management system into a Google Sheet and send each list as a batch, or connect a guest form to Mailr with one HTTP step in Zapier or n8n. A test key is free and never prints, so you can try the whole flow first.

How do we keep a guest from getting two welcome letters?

Send an Idempotency-Key built from the person's ID, such as guest-welcome-{id}: a retry within 24 hours returns the first letter instead of creating a second. Save the returned letter ID on the person and skip anyone who already has one. There are no webhooks yet, so check a letter's status with GET /v1/flats/{id}.

Can we mail every home around a new campus?

Mailr mails the addresses you send. It doesn't sell lists, offer every-door neighborhood mail or verify addresses, so use your own household file or a list you buy for those ZIP codes, and send it in batches of up to 1,000.

CHURCHES

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