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.
| Plan | Per flat | 1,000 pieces | 10,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
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.
More from Mailr
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