ChatGPT direct mail: write the card, build the batch
ChatGPT direct mail works in two halves: ChatGPT restyles the postcard and turns your customer CSV into Mailr batch files, then you send each file with one curl request and Mailr prints and mails the cards. ChatGPT can't call Mailr from inside the chat yet.
What to mail from ChatGPT
| When this happens | Mail this |
|---|---|
| You attach a CSV of customers who haven't ordered in 60 days | Win-back batch files, up to 1,000 recipients each. (Win-back) |
| You attach last week's first orders | A thank-you batch with each person's first name and a shared code. (First-order thank you) |
| You want the card in your own colors and fonts | A restyled front.html and back.html that keep the print zones and merge tags. |
Set it up
- Give ChatGPT the reference. Unzip https://mailr.dev/downloads/mailr-kit.zip and attach SKILL.md to the chat. It has every endpoint, size, clear zone and template, so ChatGPT doesn't have to guess field names. To restyle a card, also attach that template's front.html, back.html and template.json.
- Attach your list. Upload a CSV with name, address, city, state, ZIP and the merge fields. Ask for batch files of at most 1,000 recipients, two-letter states, and merge values under the template's limits (first_name is 14 characters), plus a list of rows it skipped.
- Send with a test key. Run the loop below with MAILR_API_KEY set to a test key. The pieces show up in your dashboard and walk through every status in about 8 minutes without printing. Then run it again with the live key.
- Keep the ids. Each response is saved as sent-batch-N.json with the piece ids in recipient order. Keep them next to your customers so the next list skips anyone you already mailed.
Prompts and the send
Attached: SKILL.md (the Mailr API) and lapsed.csv.
Write batch-1.json, batch-2.json, ... as request bodies for POST /v1/batches,
at most 1,000 recipients per file:
kind "postcard", size "6x11", template "tmpl_winback",
from: Acme Outdoor, 1 Example Way, Phoenix, AZ 85004,
shared merge: { "promo_code": "PEAK15" },
each recipient: to { name, line1, line2, city, state, zip }
and merge { first_name, last_product }.
Two-letter states, 5-digit ZIPs, first_name at most 14 characters,
last_product at most 22. List every row you skipped and why.- A batch is all or nothing: one bad address or missing merge field fails the whole file with a 422 that names the field, and nothing is created. Fix that row and run the loop again.
- The Idempotency-Key comes from a hash of the file, so running the loop twice within 24 hours returns the first response instead of mailing twice. Test and live keys keep separate keys, so the live run isn't mistaken for a repeat.
- Never paste your API key into the chat. ChatGPT doesn't need it to write the files; the key only lives in your terminal.
- To send a restyled design, put the HTML in the batch's front and back fields instead of template.
What it costs
Each live piece is paid from your Mailr balance, printing and postage included: a 4x6 postcard is $0.85, a 6x9 $0.89 and an 8.5x11 letter $0.95 on pay as you go, less on a plan. Test pieces are free. All prices.
Templates that fit: Win-back (6x11), First-order thank you (6x9).
Questions
Can a custom GPT send the mail with an action?
Not one worth building now. OpenAI announced on September 11, 2026 that custom GPTs retire on December 11, 2026, and custom actions don't carry over to the plugins that replace them. GPT actions also can't send custom headers, so there's no Idempotency-Key to stop a double send.
Can ChatGPT send mail by itself?
Not yet. Sending from inside ChatGPT needs a plugin backed by an MCP server, and Mailr doesn't have one. For now ChatGPT prepares the files and you, your app or a coding agent like Codex makes the request.
How many people can one request mail?
Up to 1,000 per POST /v1/batches. For 10,000 people, ask ChatGPT for ten files and the loop sends them one after another.