Direct mail API for insurance agencies
Direct mail API for insurance agencies, independent P&C and life: a daily job sends one batch of renewal-review cards for policies renewing in 45 days, one request mails a welcome letter when a policy is issued, and a monthly batch reaches single-line households, all from your agency system's API or a policy export. The same key orders rack cards and event signs.
Who builds this
Operations leads and in-house developers at multi-location independent agencies who already pull policy data into a reporting database. Marketing agencies running retention and cross-sell programs for P&C and life agencies. Agency management, CRM and quoting products that want a mail step beside their email and text automations. They wire a daily job over policies by renewal date, a monthly check for single-line households, a trigger on new business and closed claims, and a print order for the office and the events the agency sponsors.
Who to mail
| Who | Why paper works | What to send |
|---|---|---|
| Policyholders up for renewal | A card before the carrier's renewal notice gives the agent the first word on price changes and coverage. | A 6x9 card 45 days out from their agent, asking them to book a review, with no premium or policy number on it. |
| Single-line households | Bundling home and auto is a conversation, and a card with the agent's photo starts it without a cold call. | A 6x11 card with the agent's photo and a QR code to request a quote on the line they don't have with you. |
| New homeowners | They're opening every piece of mail at the new address, and the agent's card is one they keep. | A 6x9 welcome-home card a week after the home policy takes effect, offering an umbrella and flood review. |
| Policyholders after a claim | A personal note after a hard week is what they remember at renewal. | A 4x6 card signed by the agent when the claim closes, with no claim details on it. |
| Commercial accounts | Owners get renewal paperwork from every direction, and a letter from their own agent asks for the updates before the carrier does. | An 8.5x11 letter 90 days before renewal listing what to send: payroll, revenue, vehicles, locations. |
| Referral sources | Realtors, lenders and auto dealers send business to the agent who remembers them. | A 6x9 thank-you card when a referred policy binds, and rack cards for their front desk. |
What to mail, and when
| When this happens | Mail this | Price |
|---|---|---|
| A policy renews in 45 days | A renewal-review card from the agent with a booking QR code, one per household rather than per policy. (6x9 postcard) | $0.89 |
| A household has auto with you but no home policy, or the reverse (a monthly check of active policies by line) | A cross-sell card offering a quote on the missing line. (6x11 postcard) | $0.99 |
| A new home policy takes effect | A welcome-home card from the agent a week after the effective date. (6x9 postcard) | $0.89 |
| A new client's first policy is issued | A welcome letter from the agent: the service team's direct line, how to file a claim, and the agency app QR code. (8.5x11 letter) | $0.95 |
| A claim closes | A check-in card from the agent, with nothing about the claim on it. (4x6 postcard) | $0.85 |
| A commercial policy renews in 90 days | A renewal-prep letter listing what the agent needs before marketing the account. (8.5x11 letter) | $0.95 |
| A quote hasn't bound after 14 days | A follow-up card: the quote is still on file and the agent's direct number. (4x6 postcard) | $0.85 |
| Three weeks before the client appreciation event | An invitation to every household on the book. (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 |
|---|---|---|
| 4x9 rack card | Agency cards for the front desk and for partner offices: realtors, lenders and dealerships. | $0.26, from 100 |
| 18x24 yard sign | Signs for the community events the agency sponsors: youth sports fields, 5Ks, school fundraisers. Add stands: true for wire H-stakes. | $4.75–$7.00, from 10 |
| 8.5x11 flyer | Handouts for event booths and the welcome folder for new clients. | $0.53, from 100 |
| 18x24 poster | A booth poster or office window sign, from one poster. | $9.60 |
| 5x7 table card | Desk cards with the review link and the agency app QR code. | $0.29, from 100 |
Systems to connect
- Agency management: Applied Epic, HawkSoft, EZLynx, AMS360. Few send webhooks, so most builds poll or export. HawkSoft's partner API returns clients changed since a timestamp, with the mailing address and each policy's effective and expiration dates; Applied Epic's APIs come through Applied DevCenter. A daily expiration report works just as well.
- Agency CRM: AgencyZoom, Salesforce. AgencyZoom's API lists customers and their policies (effective date, expiry date, product line) for a nightly job. In Salesforce, a record-triggered or scheduled flow calls Mailr with an HTTP Callout action on the flow's asynchronous path.
- Zapier, Make or n8n. EZLynx's Zapier app triggers on new or modified applicants and prospects, and any Zap or n8n flow can call POST /v1/postcards with the address.
- No software, or something else. Export the expiration list or the book as a spreadsheet and send it as a batch of up to 1,000 per request.
Code: renewal cards from a policy export, and event signs
# Daily: households with a policy renewing 45 days from today, one card per household.
# renewals.csv comes from your agency system's expiration report or your nightly sync.
# Columns: household_id, policy_id, expiration_date, name, line1, line2, city, state, zip, agent_name
import csv
import os
from datetime import date, timedelta
import requests
target = (date.today() + timedelta(days=45)).isoformat()
households = {}
with open("renewals.csv", newline="") as f:
for row in csv.DictReader(f):
if row["expiration_date"] == target:
households.setdefault(row["household_id"], row) # first policy wins; one card per household
rows = sorted(households.values(), key=lambda r: r["household_id"])
for n, start in enumerate(range(0, len(rows), 1000)):
resp = requests.post(
"https://api.mailr.dev/v1/batches",
headers={
"Authorization": f"Bearer {os.environ['MAILR_API_KEY']}",
"Idempotency-Key": f"renewal-{target}-{n}",
},
json={
"kind": "postcard",
"size": "6x9",
"front": open("mail/renewal-review/front.html").read(),
"back": open("mail/renewal-review/back.html").read(), # {{agent_name}}, a booking QR code, no premium
"recipients": [
{
"to": {k: r[k] for k in ("name", "line1", "line2", "city", "state", "zip") if r.get(k)},
"merge": {"agent_name": r["agent_name"]},
"description": f"Renewal review: household {r['household_id']}, renews {target}",
}
for r in rows[start:start + 1000]
],
"description": f"Renewal reviews for {target}",
},
timeout=60,
)
resp.raise_for_status()
print(resp.json()["id"], resp.json()["count"], resp.json()["price"])What it costs
Renewal-review cards for 400 households a month: 400 6x9 postcards at $0.89 each is $356.00 on pay as you go, or $276.00 on the Agency plan, printing and postage included. Households with a policy renewing in 45 days, one card per household, sent as one POST /v1/batches a week. Test pieces are free. All prices.
Questions
Can a renewal card show the new premium or the policy number?
It can, but it shouldn't: postcards and letters mail with no envelope. Put the agent, the renewal month and a booking link on the card, and keep premiums, policy numbers and claim details for the call or the portal. Keep the agent's license number on the design where your state asks for it on printed advertising.
Where do the addresses come from?
Your own book: the mailing address on the client record in the agency system or CRM. Mailr prints and mails to the address you send; it doesn't sell lists, verify addresses or run change-of-address checks. New-homeowner lists come from a data provider you already pay for.
What does a monthly renewal program cost?
400 6x9 cards a month is $356 on pay as you go ($0.89 each, printing and postage included). On the Agency plan ($149 a month) the same card is $0.69, which comes out ahead once an agency mails more than about 745 6x9 cards a month.
Can every agent mail under their own name?
Yes. Send each agent's return address as from on the request, and their name and photo in the design or as merge fields. Leave from out and Mailr uses the agency address saved in Settings.
We sell life and benefits too. Is that covered?
Life policyholders, yes: policy anniversaries and beneficiary-review cards work the same way as P&C renewals. Mailr isn't HIPAA compliant, so leave health and medical details off every piece, including anything about a client's health plan.