1What FoxPlug reads from Lemon Squeezy
These are the exact things it reads, and nothing else.
| What | The details it takes |
|---|---|
| Subscriptions | up to 5 pages of 100 subscriptions: status, created at, updated at, test mode, and the first subscription item's price id and quantity. Test-mode subscriptions are left out. |
| Store currency | the first store's currency; if it cannot be read, usd is used. |
| Prices | for up to 25 distinct price ids: unit price, renewal interval unit and renewal interval quantity, used to turn each subscription into a monthly amount. A price that cannot be read adds 0 to monthly revenue while the counts stay right. |
| Active subscribers and monthly revenue | subscriptions with status active are counted and their monthly amounts added up. |
| Past-due subscriptions | status past due or unpaid: how many, and the monthly amount at risk. |
| New and cancelled in 30 days | new = created at in the last 30 days; cancelled = status cancelled or expired with updated at in the last 30 days. |
2Moments it finds, and what each becomes
A moment is one thing that happened in Lemon Squeezy worth a second look. Each one is scored, then it becomes a post, a changelog entry, a thing to fix or an idea to email, or it is skipped.
The first active subscriber appears
The moment is titled like this: 💸 Got the first paying customer
A maker connects Lemon Squeezy and presses Check for what's new. One subscription is active, so the moment reads 'Got the first paying customer' with the line 'Someone is paying for the thing I'm building (counted from Lemon Squeezy).' A post is drafted for review.
Active subscribers reach 10, 50 or 100
The moment is titled like this: Passed 10 paying subscribers
The 10th active subscription is read. The moment 'Passed 10 paying subscribers' is written once, described as '10 people now pay for it every month (counted from Lemon Squeezy).'
One or more subscriptions are past due or unpaid
The moment is titled like this: No milestone. Brief line like '2 subscriptions are past due, $48 a month at risk.'
Two subscriptions show past due. The monthly amount at risk is added up from their prices and the brief puts a Fix line ahead of any post.
Monthly revenue crosses a milestone number between two reads
The moment is titled like this: Brief line: 'You passed $1,000 a month. Tell people.'
A first read shows $940 a month and a later read at least a day on shows $1,060. The brief offers a Say line for crossing $1,000.
3How the brain uses it
The rules below are the ones that apply to Lemon Squeezy. The same rules, with worked examples, are on the brain page.
- Lemon Squeezy, Paddle and Polar report past-due subscriptions, which become the fix line. How the brain decides
- The first paying customer, then 10, 50 and 100 subscribers, become say lines. How the brain decides
- Crossing a monthly revenue milestone ($100 up to $50,000) becomes a Say line. How the brain decides
- Card expiry, saving customers and win-back need each customer's details, so they stay Stripe only. How the brain decides
4Set up Lemon Squeezy in a few steps
Access: API key pasted into FoxPlug. What to give it: API key (FoxPlug only reads). Tile copy: 'Read your subscriptions: active, new, cancelled and past due, plus monthly revenue.'.
- In Lemon Squeezy, open Settings and then API (the in-app link goes there).
- Press the plus button to make a new API key and name it FoxPlug. If Lemon Squeezy offers a read-only option, pick it; FoxPlug only reads.
- Copy the key now and paste it into the Lemon Squeezy box in FoxPlug. Lemon Squeezy may show it only once.
5Limits worth knowing
Where it stops, so nothing surprises you.
- At most 500 subscriptions are read (5 pages of 100).
- At most 25 distinct prices are looked up; subscriptions on any other price add 0 to monthly revenue.
- Monthly revenue is worked out from each subscription's first item and quantity only.
- Cancelled in 30 days uses the subscription's last-updated time, since the code reads no cancel date.
- No failed-payment rescue, expiring card, saving or win-back drafts: those are Stripe only.
6What it never reads
Read only means read only, and the list below is what the code leaves alone.
- Customer emails. No customer email is read or stored.
- Test-mode subscriptions.
- Anything written back: the key is only used for GET reads, nothing is written to Lemon Squeezy.
7How Lemon Squeezy differs from the tools next to it
Lemon Squeezy gives subscriptions with a status, a created and updated time and a separate price record, and the store's currency, so FoxPlug reads subscriptions, then prices, then the store. Unlike Paddle, price and billing cycle are not on the subscription, they come from a second /prices read (up to 25 prices). Unlike Gumroad, it reads real subscriptions, so monthly revenue is a true monthly figure and past-due is counted; Gumroad has only 30 days of sales. It reports past due (past due or unpaid) like Paddle; Gumroad and RevenueCat do not.
8Questions
Does FoxPlug see my customers' emails from Lemon Squeezy?
No. It reads subscription status, dates, price and store currency. No customer email is read or stored.
Does it include test-mode subscriptions?
No. Subscriptions marked test mode are left out, so only real subscribers count.
What does FoxPlug do with the numbers?
It keeps active subscribers, monthly revenue, new and cancelled in 30 days and past due, and the brief uses them. Past-due subscriptions become the fix line, and the first customer and 10, 50, 100 subscribers become things to post about.
When does it read Lemon Squeezy?
When you press Check for what's new or Build the brief, never on a timer.
FoxPlug reads this tool only when you press Check for what's new, and only to read. Plans and limits are on the pricing page. Questions: support.