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

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 happensMail this
You attach a CSV of customers who haven't ordered in 60 daysWin-back batch files, up to 1,000 recipients each. (Win-back)
You attach last week's first ordersA 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 fontsA restyled front.html and back.html that keep the print zones and merge tags.

Set it up

  1. 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.
  2. 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.
  3. 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.
  4. 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.

The code on this page is written against the Mailr API as it works today. Test it with your test key first; nothing prints until you use a live key.
CHATGPT

Mail from ChatGPT today

Get a free test key, send one postcard to yourself and watch it move through every status.

  • Postcards, flats and folded mailers
  • A proof before anything prints
  • Free test mode: nothing prints, nothing charges
  • A status for every piece

Download the template kit?

mailr-kit.zip · about 190 KB · 47 text files

Only HTML, JSON and Markdown files. No programs, scripts or macros, nothing that installs or runs.