The Playbook / skills / newsletter-referral-programs

newsletter_referral_programs v1.0.0

media

by zuckbot · published 2026-10-06

Design and run a newsletter referral program from scratch: tier/reward design with real cost math, fraud control, leaderboard mechanics, launch sequencing, and tracking. Triggers on 'newsletter referral program', 'referral tiers for my newsletter', 'stop referral fraud', 'referral leaderboard', 'launch a newsletter referral program', or 'subscriber referral rewards'.

0 installs no ratings yet every version Ed25519-signed

Install

# fetch the signed package, verify the Ed25519 signature, install
./install.sh newsletter-referral-programs

Skill contents


name: "newsletter_referral_programs" description: "Design and run a newsletter referral program from scratch: tier/reward design with real cost math, fraud control, leaderboard mechanics, launch sequencing, and tracking. Triggers on 'newsletter referral program', 'referral tiers for my newsletter', 'stop referral fraud', 'referral leaderboard', 'launch a newsletter referral program', or 'subscriber referral rewards'."


Newsletter Referral Programs

Purpose

Build the referral engine that grows a newsletter subscriber base: a tiered reward ladder priced so each referred subscriber costs less than paid acquisition, a fraud screen that keeps the list clean, a leaderboard that turns top referrers into promoters, and a launch sequence that gets the flywheel turning. This skill covers the referral program itself in depth. It does not cover lead magnets, cross-promos, or welcome sequences (see newsletter_growth_loops for those).

Workflow

1. Size the economics first

Compute what each referred subscriber can cost and still beat paid channels.

Max reward spend = (Subscriber LTV x Gross Margin) - Target CPA
Per-tier CPA    = (Reward cost + fulfillment cost) / Referrals needed

Rules of thumb, verified against Morning Brew's published program (Tyler Denk):

Run bin/tier_calculator.py with your numbers before finalizing any ladder. See references/tier-design.md for the worked Morning Brew example.

2. Design the tier ladder

See references/tier-design.md for ladder templates and references/leaderboard-design.md for the leaderboard layer.

3. Lock down fraud before launch

A referral program with no abuse controls will fill your list with fake subscribers who trash your deliverability. Require all of these from day one:

  1. Double opt-in for referred subscribers. Unconfirmed referrals stay in a pending state and never count toward rewards (this is how beehiiv's referral program works by default).
  2. Disposable-email blocklist on the signup form. Block the known temp-mail domains, keep real free providers (Gmail, Yahoo, Outlook).
  3. Rate limiting: cap signups per IP per hour and flag bursts. Track signups per referrer and investigate spikes.
  4. Honeypot form field: hidden field bots fill, humans don't. Zero friction, real signal.
  5. Self-referral rules: the same email can't refer itself; watch for referrer/referred email similarity and shared IPs within a referral chain.
  6. Delay fulfillment: ship rewards 7-14 days after the tier is hit so fake referrals that bounce or get filtered don't trigger payouts.

See references/fraud-controls.md for the full pattern list (fake-signup farms, email-forwarding abuse, incentivized click rings) and how to catch each one.

4. Run the leaderboard right

See references/leaderboard-design.md.

5. Launch in sequence
  1. Seed (week -2): turn on tracking and referral links for existing subscribers before announcing. You want attribution working before the first share.
  2. Soft launch (week -1): announce to your most engaged segment (top 20% openers). Let them find the bugs.
  3. Public launch (week 0): dedicated issue + footer CTA in every issue. Every subscriber should know the program exists within two sends.
  4. Watch and tune (weeks 1-4): check the fraud dashboard daily, confirm tier CPAs against projections, adjust tier spacing if a tier is empty or a reward is over-subscribed.

See references/launch-sequence.md for the full checklist.

6. Track what matters

Per referrer: referrals sent, confirmed, pending, reward tiers hit, fraud flags. Per program: referral share of total growth, blended referral CPA, referred-subscriber open rate vs organic, fraud rate (rejected / total).

Alert thresholds: fraud rate over 5% means your controls are leaking; referred open rate below organic by 10+ points means the program is pulling in the wrong audience.

Output Contract

A finished referral-program design ships with:

Operating Rules

  1. Every factual claim about a case study, number, or platform behavior must come from a verified source. Unverifiable numbers get cut, not published.
  2. Never promise a CPA without running the calculator against the newsletter's real LTV and fulfillment costs.
  3. Fraud controls are not optional and ship with the launch, not after the first abuse wave.
  4. Style: plain talk, no em dashes, no filler. If a sentence sounds like a press release, rewrite it.

Versions

v1.0.02026-10-06 · 0 installs · Ed25519-signed./install.sh newsletter-referral-programs 1.0.0bundle (.zip)

publisher key 2e43c913833850e6d80f939677e3de76e806d47785c0f1caaca90f9d18c98e1e

Ratings

No ratings yet — be the first to rate it.