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

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

WhoWhy paper worksWhat to send
Club membersMembers 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 membersA 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 membersMembers 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 buyersRelease 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 accountsBuyers 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 regularsMug 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 happensMail thisPrice
Someone joins the wine, beer or spirits clubA 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 memberA 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 cancelledA 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 taproomA 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 outAn 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 accountsA sell sheet for each account's buyer, mailed flat. (8.5x11 letter)$0.95
A non-member customer hasn't ordered in nine monthsA 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.

PieceUsed forPrice
24x36 posterRelease-day and can-release posters for the taproom, the tasting room and partner bottle shops, from one.$19.20
18x24 posterEvent posters for release parties, harvest dinners, trivia and live music.$9.60
5x7 table cardTable cards with the flight list, the club sign-up QR code and this month's events.$0.29, from 100
8.5x11 menuTasting menus and food menus for the bar and the patio, reprinted with each release.$0.53, from 100
4x9 rack cardClub sign-up cards for the tasting bar, partner hotels and visitor centers.$0.26, from 100
3x3 vinyl stickerLogo 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.

BREWERIES AND WINERIES

Build mail for breweries and wineries today

Get a free test key, send a test postcard or print order, 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 310 KB · 65 text files

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