Direct mail API for mortgage lenders
Direct mail API for mortgage lenders, brokers and credit union mortgage teams: one request mails a welcome letter when an application comes in or a thank-you card when a loan funds, and a monthly batch sends home-anniversary cards to past borrowers, triggered by your origination system's webhooks or a funded-loans report. The same key orders the branch's seminar flyers and rack cards.
Who builds this
Developers at independent mortgage banks, brokers and credit unions who already take loan events from the origination system or replicate loans into a warehouse. Marketing agencies and fractional CMOs running past-client and realtor-partner programs for loan officers. Point-of-sale, CRM and marketing platforms for lenders that want mail beside email and text. They wire a trigger on loan milestones, a nightly job over funded loans for anniversaries and reviews, and print orders for the branch and homebuyer seminars.
Who to mail
| Who | Why paper works | What to send |
|---|---|---|
| Borrowers in process | Between application and closing they get dozens of emails, and one signed letter with the team's names and numbers stands apart. | An 8.5x11 letter from the loan officer after the application comes in: who's on the team, what happens next, how to reach them. |
| Borrowers who just closed | A card from the loan officer arrives at the new address while they're still unpacking. | A 6x9 thank-you card after funding, with a review link. |
| Past clients | Homeowners refinance and buy again years later, and they call the loan officer they still hear from. | A 4x6 home-anniversary card every year, and a 6x9 "let's review your loan" card when rates move. |
| Pre-approved buyers still shopping | House hunting can run for months, and a card keeps the pre-approval and the loan officer in view. | A 6x9 card 60 days after pre-approval if no purchase contract has come in. |
| Real estate agent partners | Agents send buyers to the lenders who close on time and say thank you. | A 6x9 thank-you card after each closed referral, and seminar invitations for their buyers. |
| First-time buyers | A seminar invitation on the fridge stays in view until the date. | A 5.5x8.5 invitation three weeks before a homebuyer seminar. |
What to mail, and when
| When this happens | Mail this | Price |
|---|---|---|
| An application comes in (an application milestone in your origination or point-of-sale system) | A welcome letter from the loan officer: the team, the next steps and the direct numbers. No loan number or terms on the page. (8.5x11 letter) | $0.95 |
| A loan funds | A thank-you card to the borrower at the property address, with a review link. (6x9 postcard) | $0.89 |
| A loan funds on a referral from a real estate agent | A thank-you card to the agent, signed by the loan officer. (6x9 postcard) | $0.89 |
| A year after funding, and every year after | A home-anniversary card with the loan officer's photo. (4x6 postcard) | $0.85 |
| A pre-approval is 60 days old with no purchase contract | A card asking how the search is going, with the loan officer's direct number. (6x9 postcard) | $0.89 |
| Market rates fall below a past client's note rate by the margin you set | A "let's review your loan" card with no rate or payment on it. (6x9 postcard) | $0.89 |
| Three weeks before a homebuyer seminar | An invitation to pre-approved buyers, renters on your list and partner agents' clients. (5.5x8.5 postcard, Event invite) | $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 |
|---|---|---|
| 8.5x11 flyer | One-page program sheets for first-time buyer seminars and the branch lobby. | $0.53, from 100 |
| 4x9 rack card | Loan officer cards for the branch lobby and builder sales offices. | $0.26, from 100 |
| 5x7 table card | Seminar tables: the pre-approval QR code and the loan officer's NMLS ID. | $0.29, from 100 |
| 18x24 poster | An easel sign at the seminar door or a builder's model home, from one poster. | $9.60 |
Systems to connect
- Loan origination: Encompass, LendingPad, BytePro. Encompass sends signed webhooks for Loan events, including milestone, fieldchange, lock and unlock; read the loan's milestones (GET /encompass/v1/loans/{id}/milestones) to see which one finished. With any system, a nightly funded-loans report with the borrower's mailing address and the property address does the same job.
- Point of sale: Floify, Blend. Floify business rules can trigger on milestones and loan fields and call a webhook, which then calls Mailr. Use whichever event marks a submitted application.
- CRM: Salesforce, Total Expert, GoHighLevel. A Salesforce record-triggered flow calls Mailr with an HTTP Callout action on its asynchronous path; a HighLevel workflow calls it when a contact reaches a stage such as Funded or Pre-approved.
- No software, or something else. Export funded loans or past clients as a spreadsheet and send it as a batch of up to 1,000 per request.
Code: a card when a loan funds, and the monthly anniversary run
// Call this from whatever marks a loan funded: an origination-system webhook, a nightly report, a button.
// loan is your own record: { id, borrower_first_name, borrower_name, property: { line1, line2, city, state, zip }, lo }
import { readFile } from "node:fs/promises";
const front = await readFile("mail/funded-thank-you/front.html", "utf8"); // {{first_name}}, {{lo_name}}, {{lo_nmls}}
const back = await readFile("mail/funded-thank-you/back.html", "utf8");
export async function onLoanFunded(loan) {
if (loan.funded_card_id) return loan.funded_card_id;
const p = loan.property; // a purchase: mail the new home
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": `loan-funded-${loan.id}`, // a repeated milestone event can't mail twice
},
body: JSON.stringify({
size: "6x9",
front,
back,
to: { name: loan.borrower_name, line1: p.line1, ...(p.line2 ? { line2: p.line2 } : {}), city: p.city, state: p.state, zip: p.zip },
from: loan.lo.return_address, // each loan officer mails under their own name
merge: { first_name: loan.borrower_first_name.slice(0, 14), lo_name: loan.lo.name, lo_nmls: loan.lo.nmls_id },
description: `Funded thank-you: loan ${loan.id}`, // no loan number or terms on the card itself
}),
});
const card = await res.json();
if (!res.ok) throw new Error(card.error.message);
await saveOnLoan(loan.id, { funded_card_id: card.id }); // your own update
return card.id;
}What it costs
Home-anniversary cards for 600 funded loans a year: 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. One card on each funding anniversary, sent monthly as one POST /v1/batches from the funded-loans table, with the loan officer's photo and NMLS ID on the back. Test pieces are free. All prices.
Questions
What can a card say about the loan?
As little as possible: postcards and letters mail with no envelope, so leave off loan numbers, balances, rates and payments. Under Regulation Z, a rate on the card must come with the APR, and a payment or down payment brings more required disclosures; a card that invites a review without numbers needs neither. Keep the loan officer's NMLS ID and the Equal Housing Lender mark your compliance team requires on every design.
Which address do we mail?
Before closing, the current mailing address on the application; after a purchase funds, the property address. Mailr prints and mails to the address you send; it doesn't verify addresses, run change-of-address checks or sell lists.
Can each loan officer mail under their own name?
Yes. Send each loan officer's return address as from, and their name, photo and NMLS ID in the design or as merge fields. One account and one API key cover every branch and loan officer; put the branch or officer in description to find their pieces later.
What does a past-client program cost?
Home-anniversary cards are 4x6 at $0.85 each on pay as you go, so 600 a year is $510, printing and postage included. On the Agency plan ($149 a month) the card is $0.66, which comes out ahead past about 785 4x6 cards a month.
How do we keep milestone events from mailing twice?
Webhooks can deliver the same event more than once. Send an Idempotency-Key built from the loan, like loan-funded-1043287: the same key within 24 hours returns the first card instead of a second one. Save the returned id on the loan so later reruns skip it.