4x6 postcard printing and mailing API, $0.85 a card
4x6 postcard printing and mailing from one API request: send the address and your design or a template, and Mailr prints the card in full color, addresses it and hands it to USPS. $0.85 a card with postage on pay as you go, $0.66 on Agency. The cheapest piece to automate for reminders, review asks and small nudges.
- One request per card
- Postage included
- Free test key
- Batches of up to 1,000
Send a 4x6 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-4x6-1" \
-d '{ "kind": "postcard", "size": "4x6", "template": "tmpl_review_request",
"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 4x6
4x6 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.85 | $850.00 | $8,500.00 |
| Studio$129.00/month | $0.75 | $750.00 | $7,500.00 |
| Agency$149.00/month | $0.66 | $660.00 | $6,600.00 |
4x6 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
- 6 × 4 in
- Page with bleed
- 6.25 × 4.25 in (600 × 408 px)
- Bleed and safe area
- 0.125 in bleed; keep text 0.125 in inside the trim
- Address block
- Back, 3.2835 × 2.375 in at 2.5665, 1.5 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
"4x6"on/v1/postcards- Smallest text
- 8pt
4x6 postcard questions
How much does a 4x6 postcard cost through the API?
$0.85 per card on pay as you go, $0.75 on Studio and $0.66 on Agency, with printing, addressing and USPS postage included. Test cards are free.
What's the smallest order?
One card. Each live request is charged from your prepaid balance, and you can send one card or a batch of up to 1,000 per request.
Can my coding agent build the integration?
Yes. Download the template kit: it has every template, the blank layouts and a SKILL.md that tells an agent how to call the API, which sizes exist and where the address block sits.
Is there a 4x6 template?
Yes, the review request template is 4x6. Send template: tmpl_review_request with first_name, product_name and review_url, or send your own front and back HTML at 6.25 × 4.25 in with bleed.
More from Mailr
Send your first 4x6 from code
Get a free test key, send one card to yourself and watch it move through every status.
- $0.85 per 4x6, postage included
- Free test key: nothing prints, nothing charges
- Up to 1,000 per request
- A status for every piece