Nonprofit direct mail from gifts, giving plans and your donor CRM
Nonprofit direct mail can run off the events your giving platform already sends: a Givebutter transaction.succeeded mails a thank-you card, a new monthly plan mails a welcome letter, and the year-end appeal goes out in batches of 1,000 from your CRM export.
Who builds this
Few nonprofits employ developers, so this gets built by the database or CRM manager who keeps Salesforce or Bloomerang in shape, by volunteer developers, by the agencies and consultants that run fundraising programs for several organizations, and by fundraising platforms adding mail to their product. They connect gift and recurring-plan events to thank-you mail, pull appeal segments from the donor file, and order posters and flyers for galas, runs and drives.
What to mail, and when
| When this happens | Mail this | Price |
|---|---|---|
| Givebutter transaction.succeeded | A thank-you postcard from the executive director naming what the gift supports. No amount on the card. (6x9 postcard) | $0.89 |
| GoFundMe Pro recurring_donation_plan.created, or Givebutter plan.created | A welcome letter for new monthly donors: what a month of giving does and who to call with questions. (8.5x11 letter) | $0.95 |
| Salesforce NPSP: a donation Opportunity reaches Closed Won above your major-gift threshold | A personal letter from the board chair, mailed flat. (8.5x11 letter) | $0.95 |
| Each fall: donors who gave last year but not this year, from Donorbox or your CRM | A short appeal card that names their last gift's year and the campaign they supported. (6x11 postcard) | $0.99 |
| Year-end: the whole donor file, segmented in your CRM export | The year-end appeal as an 11x17 mailer folded to 8.5x11, with room for a story and a reply ask. (11x17 folded mailer) | $1.39 |
What nonprofits print
Printed and picked up free in Phoenix or shipped UPS Ground, ordered with POST /v1/prints.
| Piece | Used for | Price |
|---|---|---|
| 18x24 poster | Event posters for the gala, the 5K or the food drive, printed one side. | $9.60 |
| 8.5x11 flyer | Event and volunteer flyers for churches, schools and storefront windows. | $0.53, from 100 |
| 4x9 rack card | Giving cards with the donation link for event tables and partner counters. | $0.26, from 100 |
| 5x7 table card | Gala table cards with the paddle-raise or text-to-give instructions. | $0.29, from 100 |
Systems to connect
- Givebutter. Webhooks under Settings > Developers > Webhooks: transaction.succeeded (not fired for CSV imports), plan.created, plan.canceled, ticket.created and more. The payload's address object (address_1, address_2, city, state, zipcode) maps to Mailr's to, and a Signature header carries your signing secret.
- GoFundMe Pro (Classy). Webhooks, delivered through Svix, cover supporter, transaction and recurring donation events, including recurring_donation_plan.created and recurring_donation_plan.updated.
- Salesforce NPSP. Donations are Opportunities. A record-triggered flow on Closed Won calls Mailr with an HTTP Callout action on an asynchronous path, with the API key kept in a named credential.
- Bloomerang. Its REST API is a private-key, server-to-server API. A nightly job pulls new transactions with the constituent's address and mails the gifts you haven't thanked yet.
- Donorbox. GET https://donorbox.org/api/v1/donations with date_from, using your login email and API key as Basic auth. API access and custom webhooks come with Donorbox's paid API add-on.
Code: Givebutter thank-yous, the year-end appeal and gala prints
// app/api/givebutter/route.js. In Givebutter: Settings > Developers > Webhooks, event transaction.succeeded.
import { timingSafeEqual } from "node:crypto";
import { readFileSync } from "node:fs";
const FRONT = readFileSync("mail/thank-you/front.html", "utf8");
const BACK = readFileSync("mail/thank-you/back.html", "utf8");
export async function POST(req) {
// Givebutter sends your webhook's signing secret in the Signature header.
const sig = Buffer.from(req.headers.get("signature") ?? "");
const secret = Buffer.from(process.env.GIVEBUTTER_SIGNING_SECRET);
if (sig.length !== secret.length || !timingSafeEqual(sig, secret)) return new Response("Unauthorized", { status: 401 });
const { event, data } = await req.json();
const a = data.address;
if (event !== "transaction.succeeded" || !a?.address_1 || !/^(US|USA|United States)$/i.test(a.country ?? "")) {
return new Response("skipped");
}
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": `gb-thanks-${data.id}`,
},
body: JSON.stringify({
size: "6x9",
front: FRONT, // uses {{first_name}}
back: BACK,
to: {
name: `${data.first_name} ${data.last_name}`.slice(0, 40),
line1: a.address_1,
line2: a.address_2 || undefined,
city: a.city,
state: a.state, // Mailr wants a two-letter code
zip: a.zipcode,
},
merge: { first_name: data.first_name.slice(0, 14) }, // never the amount: postcards mail without an envelope
description: `Thank-you, Givebutter transaction ${data.id}`,
}),
});
if (!res.ok) console.error("Mailr", res.status, (await res.json()).error?.message);
return new Response("ok");
}What it costs
Year-end appeal to 2,500 donors: 2,500 11x17 folded mailers at $1.39 each is $3,475.00 on pay as you go, or $2,600.00 on the Agency plan, printing and postage included. An 11x17 mailer folded to 8.5x11 for every donor on file, sent as three batches (1,000, 1,000 and 500). Test pieces are free. All prices.
Questions
Is there a nonprofit postage rate?
No. Mailr has no separate nonprofit price; every sender pays the same plan prices, printing and postage included: a 6x9 postcard is $0.89 and an 11x17 folded mailer is $1.39 pay as you go, or $0.69 and $1.04 on the Agency plan ($149 a month).
Can the thank-you card double as the tax receipt?
Keep them apart. Postcards and flats mail without an envelope, so gift amounts shouldn't be printed on them. Send the receipt by email from your giving platform and let the card do the thanking.
How do I mail a 2,500-donor appeal?
Split the file into batches of up to 1,000 and send each to POST /v1/batches with its own Idempotency-Key. Each batch is validated as a whole before anything is created, so one bad ZIP code stops that batch instead of half of it mailing.
Does Mailr provide donor or prospect lists?
No. Mailr mails the addresses you send. Donor addresses come from your CRM or giving platform; Givebutter's transaction.succeeded payload includes the donor's address.