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

Real estate direct mail API for MLS and CRM events

Mailr is a real estate direct mail API: when your MLS feed marks a listing Closed or Follow Up Boss logs a new seller lead, one request prints and mails the postcards, and another orders the open house yard signs.

Who builds this

Real estate mail gets built by three groups: in-house developers at brokerages and large teams who already sync an MLS feed and a CRM, agencies that run farming campaigns for dozens of agents, and the products agents log into every day (CRMs, IDX website platforms, transaction tools) that want a mail button next to every listing. They wire the same few things: a listing status change sends a batch of postcards to the agent's own farm list, a closing sends a card to the buyer's new address, a new seller lead gets a letter, and a new listing orders signs. Builders working in Claude Code or Codex hand the whole job to the agent with the Mailr skill.

What to mail, and when

When this happensMail thisPrice
MLS feed (RESO Web API): a listing's StandardStatus changes to ClosedA just-sold postcard to the listing agent's farm list, with the sold address and the agent's photo. (6x9 postcard)$0.89
MLS feed: StandardStatus changes to Coming Soon or ActiveA just-listed postcard to the same farm, with the listing photo and the open house date. (6x11 postcard)$0.99
dotloop LOOP_UPDATED, and the loop's status is now SOLDA welcome-home card from the agent, addressed to the buyer at the new house. (6x9 postcard)$0.89
Lofty Transaction webhook (listId 5) on a closing; your job schedules the anniversaryA home-anniversary card a year after closing, so past clients hear from the agent between deals. (4x6 postcard)$0.85
Follow Up Boss peopleCreated, from a seller lead sourceA one-page letter from the agent: who they are, what sold nearby and how to book a valuation. (8.5x11 letter)$0.95

What real estate print

Printed and picked up free in Phoenix or shipped UPS Ground, ordered with POST /v1/prints.

PieceUsed forPrice
18x24 yard signOpen house and directional signs, printed both sides on corrugated plastic. Add wire H-stakes with stands: true.$4.75–$7.00, from 10
8.5x11 flyerFeature sheets for the open house table and the brokerage lobby.$0.53, from 100
24x36 posterA listing poster for an easel at the open house or the office window.$19.20

Systems to connect

  • MLS feed (RESO Web API). MLSs serve the RESO Web API through vendors such as Bridge, Trestle, Spark and MLS Grid. There are no webhooks: replicate the Property resource by ModificationTimestamp, compare StandardStatus with what you stored, and act on changes to Coming Soon, Active, Pending and Closed.
  • Follow Up Boss. The account owner registers webhooks with POST /v1/webhooks (an X-System header is required) for peopleCreated, peopleStageUpdated or peopleTagsCreated. Each event carries resourceIds and a uri; GET the uri for the person and their address.
  • Lofty. Subscribe with POST https://api.lofty.com/v1.0/webhook and a listId: 2 for Lead Info, 5 for Transaction, 12 for Pipeline Change. Deliveries retry with the same Lofty-Webhook-Id header, so deduplicate on it.
  • dotloop. Public API v2 webhook subscriptions on a profile send LOOP_CREATED and LOOP_UPDATED. Fetch the loop and mail only when its status is SOLD (or LEASED for rentals).
  • GoHighLevel. Teams that run on HighLevel call Mailr from a workflow when a contact reaches a pipeline stage such as Closed or Past Client.

Code: a just-sold batch and open house signs

# mail/just-sold/front.html and back.html use {{sold_address}} and {{agent_name}}.
# "from" is left out: the brokerage's return address is saved in Settings.
jq -n \
  --rawfile front mail/just-sold/front.html \
  --rawfile back mail/just-sold/back.html \
  '{
    kind: "postcard",
    size: "6x9",
    front: $front,
    back: $back,
    description: "Just sold: 4417 E Example Dr",
    merge: { sold_address: "4417 E Example Dr", agent_name: "Dana Ruiz" },
    recipients: [
      { to: { name: "Current Resident", line1: "4421 E Example Dr", city: "Phoenix", state: "AZ", zip: "85018" } },
      { to: { name: "Current Resident", line1: "4409 E Example Dr", city: "Phoenix", state: "AZ", zip: "85018" } }
    ]
  }' |
curl https://api.mailr.dev/v1/batches \
  -H "Authorization: Bearer $MAILR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: just-sold-1043287-1" \
  --data @-

# → 201 { "id": "bat_…", "object": "batch", "kind": "postcard", "size": "6x9", "count": 2, "pieces_url": "…", … }

What it costs

Just-sold postcards to a 500-home farm: 500 6x9 postcards at $0.89 each is $445.00 on pay as you go, or $345.00 on the Agency plan, printing and postage included. One 6x9 card per address in the agent's farm, sent as one batch when the MLS marks the listing Closed. Test pieces are free. All prices.

Questions

Does Mailr supply the farm list or the addresses around a listing?

No. Mailr prints and mails to the addresses you send; it doesn't sell lists or look up neighbors. Use the agent's own farm, sphere and past-client lists, or addresses from a data provider you already pay for, and send up to 1,000 per batch.

What does an open house sign order cost?

18x24 signs printed both sides are $7 each for 10–100, $6 for 101–250 and $4.75 for 251 or more, plus $0.75 per wire stand. Pickup in Phoenix is free; UPS Ground in the lower 48 is $16 per box of 25. POST /v1/prints/quote returns the exact price before you order.

What does a just-sold run cost?

A 6x9 postcard is $0.89 pay as you go, printing and postage included, so 500 cards is $445. On the Agency plan ($149 a month) the same card is $0.69.

How do I keep a re-synced MLS feed from mailing the farm twice?

Send an Idempotency-Key built from the ListingKey, like just-sold-1043287-1. The same key within 24 hours returns the first batch instead of creating another. Save the batch id on the listing so later syncs skip it.

Whose return address goes on the card?

Whatever you send as from: the agent, the team or the brokerage office. Save one in Settings and from becomes optional; pass it on each request when every agent mails under their own name.

REAL ESTATE

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