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

Letter mailing API: 8.5x11 letters mailed flat for $0.95

A letter mailing API without the envelope: Mailr prints an 8.5x11 sheet in full color and mails it flat with the address on the front. One request per letter. $0.95 with postage on pay as you go, $0.92 on Agency. Built for founder welcomes, billing notices and anything that should read like a letter.

  • One request per letter
  • Mailed flat, no envelope
  • Templates included
  • Free test key

Send a 8.5x11 flat from code

One POST /v1/flats per piece, or up to 1,000 people in one POST /v1/batches. Build against your test key: test pieces are free, never print, and walk through every status in about 8 minutes. Switch to the live key and the same request prints and mails.

curl https://api.mailr.dev/v1/batches \
  -H "Authorization: Bearer $MAILR_API_KEY" \
  -H "Idempotency-Key: spring-8.5x11-1" \
  -d '{ "kind": "flat", "size": "8.5x11", "template": "tmpl_welcome",
        "recipients": [ { "to": { … }, "merge": { … } }, … ] }'

Send an Idempotency-Key so a retry never prints twice, then poll GET /v1/flats/{id} or list a batch with ?batch=bat_…. API reference · template kit with SKILL.md for coding agents.

What developers trigger with a 8.5x11

8.5x11 letter (flat) API pricing

One price per live piece covers printing, addressing and USPS postage, taken from your prepaid balance when the request is accepted. Test pieces cost nothing. Prices as of November 18, 2026.

PlanPer flat1,000 pieces10,000 pieces
Pay as you goNo monthly fee$0.95$950.00$9,500.00
Studio$129.00/month$0.94$940.00$9,400.00
Agency$149.00/month$0.92$920.00$9,200.00

8.5x11 letter (flat) specs

Build your HTML to these numbers (96 px per inch) and it prints the way it renders. The pre-print check flags anything outside them before a live piece prints.

Trim size
8.5 × 11 in
Page with bleed
8.75 × 11.25 in (840 × 1080 px)
Bleed and safe area
0.125 in bleed; keep text 0.125 in inside the trim
Address block
Back, 4 × 2.375 in at 4.25, 0.25 in from the top left of the trim. Leave it empty: Mailr prints the addresses, postage and barcode there.
Paper and color
Full color, mailed flat with no envelope
USPS
USPS flat: the address goes in the top half of the sheet. Mailed with USPS Marketing Mail.
API size value
"8.5x11" on /v1/flats
Smallest text
8pt
  • Bleed 0.125 in
  • Trim 8.5×11 in
  • Safe area
  • Keep clear
Front
Back (address side)

8.5x11 letter (flat) questions

Do letters go in an envelope?

No. Mailr mails the 8.5x11 sheet flat, with the address printed in the top right of the address side. Keep sensitive details off it, since a flat is open mail.

How much does a letter cost?

$0.95 on pay as you go, $0.94 on Studio and $0.92 on Agency, printing and postage included.

Which templates fit?

tmpl_welcome (first_name, company, founder_name) and tmpl_payment_failed (first_name, plan, update_url). Or send your own HTML at 8.75 × 11.25 in with bleed.

LETTERS

Send your first letter from code

Get a free test key and send the welcome letter template to yourself.

  • $0.95 per 8.5x11, postage included
  • Free test key: nothing prints, nothing charges
  • Up to 1,000 per request
  • A status for every piece