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

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 happensMail thisPrice
Givebutter transaction.succeededA 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.createdA 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 thresholdA 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 CRMA 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 exportThe 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.

PieceUsed forPrice
18x24 posterEvent posters for the gala, the 5K or the food drive, printed one side.$9.60
8.5x11 flyerEvent and volunteer flyers for churches, schools and storefront windows.$0.53, from 100
4x9 rack cardGiving cards with the donation link for event tables and partner counters.$0.26, from 100
5x7 table cardGala 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.

NONPROFITS

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