Direct mail API for financial advisors
Direct mail API for financial advisors, RIAs and wealth teams: a nightly job reads client dates from your CRM or an export and sends review letters, birthday cards and retirement cards as batches of up to 1,000, and one batch per season covers the holiday card and the client event invitation. The same key orders seminar table cards and flyers.
Who builds this
Operations and technology leads at RIAs and wealth management firms who already pull CRM and portfolio data into a reporting database. Marketing agencies and consultants running client-experience programs for advisors. Advisor-tech products (CRMs, client portals, planning tools) that want mail next to email. They wire a nightly job over client dates (birthdays, client-since anniversaries, retirement dates, next review dates), an event invitation batch, and a print order before each seminar. Every design goes through the firm's compliance review first, and the approved HTML or PDF is exactly what the API prints.
Who to mail
| Who | Why paper works | What to send |
|---|---|---|
| Clients due for an annual review | A letter from the advisor a month ahead gets the meeting on the calendar before it fills. | An 8.5x11 letter with the booking link and what to bring, and no account values on the page. |
| Clients on their birthday | The custodian sends statements; a signed card is the mail that comes from the advisor. | A 4x6 card in their birth month. |
| Clients nearing retirement | The retirement date is the biggest planning moment in the relationship. | A 6x9 card a year out inviting a retirement income meeting, and a congratulations card on the date. |
| Every client household | An invitation or a holiday card on the fridge stays in view for weeks. | A 5.5x8.5 invitation three weeks before the client event, and a 6x11 holiday card in December. |
| Seminar attendees | A follow-up from the advisor they met keeps the conversation going after the room empties. | A 6x9 thank-you card the week after the seminar, with the booking QR code. |
| Centers of influence | CPAs and estate attorneys refer to the advisor who thanks them in writing. | A 6x9 thank-you card when a referred household becomes a client. |
What to mail, and when
| When this happens | Mail this | Price |
|---|---|---|
| A client's annual review is 30 days away | A review letter with the booking link and what to bring. (8.5x11 letter) | $0.95 |
| A client's birthday month starts | A birthday card signed by the advisor. (4x6 postcard) | $0.85 |
| A client's retirement date is a year away | A card inviting a retirement income meeting. (6x9 postcard) | $0.89 |
| A client-since anniversary (5, 10, 20 years) | A thank-you card for the years together. (6x9 postcard) | $0.89 |
| A new household's accounts are open | A welcome letter from the advisor: the team, how to reach them, when the first review is. (8.5x11 letter) | $0.95 |
| Three weeks before the client appreciation event or a seminar | An invitation to every household, or to prospects and centers of influence. (5.5x8.5 postcard, Event invite) | $0.89 |
| A week after a seminar, for everyone who attended | A thank-you card with the advisor's booking QR code. (6x9 postcard) | $0.89 |
| Early December: every client household | A holiday card, one per household rather than one per person. (6x11 postcard) | $0.99 |
What to print
Printed and picked up free in Phoenix or shipped UPS Ground, ordered with POST /v1/prints.
| Piece | Used for | Price |
|---|---|---|
| 5x7 table card | Seminar and client event tables: the agenda and the booking QR code. | $0.29, from 100 |
| 8.5x11 flyer | Seminar handouts and the one-page firm overview, as approved by compliance. | $0.53, from 100 |
| 18x24 poster | An easel sign at the seminar room or client event entrance, from one poster. | $9.60 |
| 4x9 rack card | Firm cards for CPA and estate attorney partners' front desks. | $0.26, from 100 |
Systems to connect
- CRM: Wealthbox, Redtail, Salesforce Financial Services Cloud. Few advisor CRMs send webhooks, so a nightly job reads client dates. Wealthbox contacts carry birth_date, client_since, retirement_date and street_addresses (polled at 1 request a second); Financial Services Cloud accounts carry FinServ__NextReview__c, and a flow can call Mailr with an HTTP Callout action.
- Portfolio and reporting: Orion, Black Diamond, Addepar. Useful for household lists and new-account dates. Keep balances and performance off mail, since every piece mails without an envelope.
- Zapier, Make or n8n. When a tag, stage or date changes in the CRM, a step calls POST /v1/postcards with the client's address.
- No software, or something else. Export households with mailing addresses as a spreadsheet and send it as a batch of up to 1,000 per request.
Code: birthday cards from a client export, and event invitations
# On the 1st of each month: birthday cards for clients born this month.
# clients.csv columns: client_id, first_name, name, birth_date (YYYY-MM-DD), line1, line2, city, state, zip, advisor
import csv
import os
from datetime import date
import requests
month = date.today().month
with open("clients.csv", newline="") as f:
due = sorted(
(c for c in csv.DictReader(f) if c["birth_date"] and int(c["birth_date"][5:7]) == month),
key=lambda c: c["client_id"],
)
for n, start in enumerate(range(0, len(due), 1000)):
resp = requests.post(
"https://api.mailr.dev/v1/batches",
headers={
"Authorization": f"Bearer {os.environ['MAILR_API_KEY']}",
"Idempotency-Key": f"birthday-{date.today():%Y-%m}-{n}",
},
json={
"kind": "postcard",
"size": "4x6",
"front": open("mail/birthday/front.html").read(),
"back": open("mail/birthday/back.html").read(), # {{first_name}}, {{advisor}}
"recipients": [
{
"to": {k: c[k] for k in ("name", "line1", "line2", "city", "state", "zip") if c.get(k)},
"merge": {"first_name": c["first_name"][:14], "advisor": c["advisor"]},
"description": f"Birthday {date.today():%Y}: client {c['client_id']}",
}
for c in due[start:start + 1000]
],
"description": f"Birthday cards {date.today():%Y-%m}",
},
timeout=60,
)
resp.raise_for_status()
print(resp.json()["id"], resp.json()["count"], resp.json()["price"])What it costs
Holiday cards to 350 client households: 350 6x11 postcards at $0.99 each is $346.50 on pay as you go, or $248.50 on the Agency plan, printing and postage included. One card per household, signed by the advisor, sent as one POST /v1/batches in early December. Test pieces are free. All prices.
Questions
Can a letter show account values or performance?
It shouldn't: postcards and letters mail with no envelope, so anything on them can be read in transit. Keep balances, account numbers and performance for the portal, the custodian's statements and the meeting. Mail the invitation to talk.
How does this fit our compliance review?
The API prints exactly the HTML or PDF you send, so the approved version lives in your repo and nothing changes it on the way. Put the approval number in each piece's description (up to 255 characters); GET /v1/postcards/{id} returns it with the piece, recipient and status, so the record of what went to whom is there when you need it.
Where do client addresses come from?
The CRM (Wealthbox street_addresses, the mailing address on a Salesforce person account, Redtail contacts) or a household export. Mailr prints and mails to the address you send; it doesn't verify addresses, run change-of-address checks or sell lists.
What does a year of client mail cost for 350 households?
Pay as you go: 350 holiday cards (6x11 at $0.99) is $346.50, about 350 birthday cards a year (4x6 at $0.85) is $297.50, and 350 review letters (8.5x11 at $0.95) is $332.50. Printing and USPS postage are included and there's no monthly fee.
Can we test it without mailing clients?
Yes. A mlr_test_ key is free and never prints, so the nightly job, the merge fields and the compliance descriptions can run against your real client export before you add funds.