5.5x8.5 postcard printing and mailing API, $0.89 a card
5.5x8.5 postcards, half a letter sheet, printed and mailed from one API request. Send the address and front and back HTML at 8.75 × 5.75 in with bleed, and Mailr prints, addresses and mails it. $0.89 a card with postage on pay as you go, $0.69 on Agency.
- Your HTML, rendered to print
- Postage included
- Free test key
- Batches of up to 1,000
Send a 5.5x8.5 postcard from code
One POST /v1/postcards 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-5.5x8.5-1" \
-d '{ "kind": "postcard", "size": "5.5x8.5", "front": "…", "back": "…",
"recipients": [ { "to": { … }, "merge": { … } }, … ] }'Send an Idempotency-Key so a retry never prints twice, then poll GET /v1/postcards/{id} or list a batch with ?batch=bat_…. API reference · template kit with SKILL.md for coding agents.
What developers trigger with a 5.5x8.5
5.5x8.5 postcard 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 postcard | 1,000 pieces | 10,000 pieces |
|---|---|---|---|
| Pay as you goNo monthly fee | $0.89 | $890.00 | $8,900.00 |
| Studio$129.00/month | $0.79 | $790.00 | $7,900.00 |
| Agency$149.00/month | $0.69 | $690.00 | $6,900.00 |
5.5x8.5 postcard 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 × 5.5 in
- Page with bleed
- 8.75 × 5.75 in (840 × 552 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.35, 3 in from the top left of the trim. Leave it empty: Mailr prints the addresses, postage and barcode there.
- Paper and color
- 100 lb silk cover, full color on both sides
- USPS
- Postcard size: USPS card prices cover cards up to 6 × 9 in (DMM 201.1.2.1). Mailed with USPS Marketing Mail.
- API size value
"5.5x8.5"on/v1/postcards- Smallest text
- 8pt
5.5x8.5 postcard questions
How much does a 5.5x8.5 postcard cost?
$0.89 per card on pay as you go, $0.79 on Studio and $0.69 on Agency, printing and postage included. That's the same price as a 6x9.
Is there a 5.5x8.5 template?
Not yet. Send your own front and back HTML; the template kit's blank layouts show the bleed, safe area and address block, and the pre-print check flags anything outside them.
How do I send 10,000 of them?
Send ten POST /v1/batches requests of 1,000 recipients each, with an Idempotency-Key on each so a retry never prints twice.
More from Mailr
Send a 5.5x8.5 from code
Get a free test key and send your HTML to yourself first.
- $0.89 per 5.5x8.5, postage included
- Free test key: nothing prints, nothing charges
- Up to 1,000 per request
- A status for every piece