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

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.

PlanPer postcard1,000 pieces10,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
  • Bleed 0.125 in
  • Trim 6×4 in
  • Safe area
  • Keep clear
Front
Back (address side)

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.

4X6 POSTCARDS

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