Direct mail API for breweries and wineries
Direct mail API for breweries and wineries: when someone joins the club, your webhook handler or nightly pull makes one API call and a welcome letter from the winemaker or head brewer is printed and mailed. Ten days before a release, every active member gets a shipment or pickup card in batches of up to 1,000, a cancellation triggers a come-back card, and release-day posters, table cards and stickers are ordered with the same API key.
Who builds this
Wine club and DTC managers who outgrew mail merges, the agencies and consultants who run club programs for several wineries, brewery and distillery ops leads who connect the taproom POS to their own customer table, and the developers of wine, beer and spirits club software. They connect club sign-ups, cancellations and orders to mail, schedule reminders around each club release, and order the posters, table cards, menus and stickers for the tasting room and release day.
Who to mail
| Who | Why paper works | What to send |
|---|---|---|
| Club members | Members are charged and shipped on a schedule, and a card with the release date, the pickup window and what's in the box arrives before the charge does. | A 6x9 card ten days before each shipment or pickup party with the date, the wines or beers, and how to customize or skip. |
| New club members | A welcome in the first week explains the first shipment and the member perks while the decision to join is fresh. | An 8.5x11 letter signed by the winemaker, head brewer or distiller, with the release calendar and member pricing. |
| Lapsed club members | Members who cancelled liked the product enough to join once, and a mailed offer reaches them after they've unsubscribed from email. | A 6x11 card a few months after cancellation with a rejoin offer or a single release they can buy without rejoining. |
| Event ticket buyers | Release parties, pickup parties and harvest dinners run on a calendar, and an invite with the date gets kept until the day. | A 5.5x8.5 invite three weeks before the next event to last year's ticket buyers. |
| Trade and wholesale accounts | Buyers at bottle shops, bars and restaurants decide what goes on the shelf and the tap list, and a sell sheet on their desk outlasts an email. | An 8.5x11 sell sheet for the new release or seasonal lineup, mailed flat to each account's buyer. |
| Taproom and tasting-room regulars | Mug club and loyalty members signed up at the bar and gave you an address, and they're the first to come to a release. | A 4x6 card on their mug club anniversary with the renewal date, and a 5.5x8.5 invite to members' release night. |
What to mail, and when
| When this happens | Mail this | Price |
|---|---|---|
| Someone joins the wine, beer or spirits club | A welcome letter from the winemaker or head brewer: the release calendar, member pricing and pickup hours. (8.5x11 letter) | $0.95 |
| A club shipment or pickup is ten days out, for every active member | A reminder with the date, what's in it, and how to customize, hold or switch to shipping. (6x9 postcard) | $0.89 |
| A club membership is cancelled | A come-back card three months later with a rejoin offer. (6x11 postcard) | $0.99 |
| A visitor who isn't a member buys in the tasting room or taproom | A thank-you card after the visit with the club offer and the next release date. (6x9 postcard) | $0.89 |
| A release party, pickup party or harvest dinner is three weeks out | An invite to members and last year's ticket buyers with the date and the release. (5.5x8.5 postcard, Event invite) | $0.89 |
| A new release or seasonal lineup is ready for trade accounts | A sell sheet for each account's buyer, mailed flat. (8.5x11 letter) | $0.95 |
| A non-member customer hasn't ordered in nine months | A win-back card naming their last bottle or 4-pack. (6x11 postcard, Win-back) | $0.99 |
What to print
Printed and picked up free in Phoenix or shipped UPS Ground, ordered with POST /v1/prints.
| Piece | Used for | Price |
|---|---|---|
| 24x36 poster | Release-day and can-release posters for the taproom, the tasting room and partner bottle shops, from one. | $19.20 |
| 18x24 poster | Event posters for release parties, harvest dinners, trivia and live music. | $9.60 |
| 5x7 table card | Table cards with the flight list, the club sign-up QR code and this month's events. | $0.29, from 100 |
| 8.5x11 menu | Tasting menus and food menus for the bar and the patio, reprinted with each release. | $0.53, from 100 |
| 4x9 rack card | Club sign-up cards for the tasting bar, partner hotels and visitor centers. | $0.26, from 100 |
| 3x3 vinyl sticker | Logo stickers for growlers, crowlers, boxes and merch bags, cut square or circle. | $0.64, from 50 |
Systems to connect
- Wine club and DTC: Commerce7, WineDirect. A webhook or a scheduled pull. Commerce7 webhooks (Developer > Web Hooks, not on C7 Lite) cover Club Membership, Order, Customer and Reservation with Create, Update and Delete actions and send the whole record; a membership has status (Active, Cancelled, On Hold), orderDeliveryMethod (Pickup or Ship) and shipToCustomerAddressId. WineDirect Classic's club membership web service searches memberships by DateModifiedFrom and CurrentMembershipStatus, so run it nightly.
- Taproom and tasting-room POS: Arryved, Square, Toast. Customers, mug club and loyalty profiles live in the POS. Square sends customer.created and customer.updated with the address when set; for the others, use the POS's customer export or API where it includes addresses. Mail only customers your club or checkout verified as 21 or older.
- Production, wholesale and menus: Ekos, Untappd for Business. Wholesale accounts live in Ekos's customer database; export the account list for each release's sell sheet. Untappd for Business Premium accounts get API access to their menus, which can feed the release-day poster, tasting menu or table cards.
- Zapier or n8n. Connect a club sign-up form, a POS trigger or a spreadsheet to Mailr with one HTTP step.
- No software, or something else. Export a spreadsheet of members or accounts with addresses, one row each, and send it as a batch of up to 1,000.
Code: a club welcome, shipment reminders and release-day prints
// Call this from whatever you have: a club-membership webhook, a nightly pull or a sign-up form.
// member is your own record: membership id, name, delivery method and mailing address.
import { readFileSync } from "node:fs";
const FRONT = readFileSync("mail/club-welcome/front.html", "utf8"); // 8.5x11 letter, uses {{first_name}} and {{club}}
const BACK = readFileSync("mail/club-welcome/back.html", "utf8");
export async function mailClubWelcome(member) {
const a = member.address;
if (!a?.line1 || !member.ageVerified) return null; // adults only: age checked at sign-up
const res = await fetch("https://api.mailr.dev/v1/flats", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.MAILR_API_KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": `club-welcome-${member.membershipId}`, // a retry within 24 hours returns the first piece instead of creating a second
},
body: JSON.stringify({
size: "8.5x11",
front: FRONT,
back: BACK,
to: { name: member.name.slice(0, 40), line1: a.line1, line2: a.line2 || undefined, city: a.city, state: a.state, zip: a.zip },
merge: { first_name: member.firstName.slice(0, 14), club: member.clubName }, // "Reserve Club"
description: `Club welcome ${member.membershipId}`,
}),
});
const letter = await res.json();
if (!res.ok) throw new Error(letter.error.message);
return letter.id; // save it on the membership so a later run skips it
}What it costs
Pickup party reminders to 800 club members: 800 6x9 postcards at $0.89 each is $712.00 on pay as you go, or $552.00 on the Agency plan, printing and postage included. Every active member ten days before the release, sent as one batch of 800 with each member's pickup window or ship date in a merge field. Test pieces are free. All prices.
Questions
Who can we mail alcohol marketing to?
Adults only. Mail club members and customers your sign-up or checkout verified as 21 or older, and leave out anyone without a verified age. Mailr mails the addresses you send and doesn't check ages.
Can the shipment reminder show what the member will be charged?
Keep amounts and card details off it. Postcards mail without an envelope, so put the date, the wines or beers and a link to the member portal on the card, and send the charge notice by email.
Where do club members' addresses come from?
The club sign-up itself: shipping members give a ship-to address and pickup members a billing address. Taproom regulars give one when they join a mug club or loyalty program.
What do posters, table cards and stickers cost?
Pay as you go: 24x36 posters $19.20 and 18x24 posters $9.60 from one, 5x7 table cards $0.29 and 8.5x11 tasting menus $0.53 from 100, 4x9 rack cards $0.26 from 100, and 3x3 stickers $0.64 from 50. Pickup in Phoenix is free; UPS Ground to the lower 48 is priced by destination.
Can we test the reminder before a real release?
Yes. A mlr_test_ key is free and never prints, and test pieces move through every status on their own, so the whole batch can run against last release's member list first.