Skip to main content

Lemon Squeezy

Available

This integration is active and ready to use in Frihet.

Connect your Lemon Squeezy store to Frihet. Import digital software products and orders, automatically record revenue, and keep all your invoicing centralized. Lemon Squeezy acts as the Merchant of Record (manages taxes for you) and Frihet records the transactions for your accounting.

Purpose​

With Lemon Squeezy integrated:

  • Import products — Bring your catalog of software and digital products into Frihet
  • Import orders — Each sale is recorded as revenue in your ERP
  • Automatic deduplication — Already imported orders are not duplicated (prefix LS-)
  • Multi-store — If you have multiple stores, select which one to import from or import from all
  • Simplified tax management — Lemon Squeezy handles taxes as MoR; Frihet records the net amounts
  • Subscriptions — Tracking recurring SaaS payments

Requirements​

  • Active Lemon Squeezy account — lemonsqueezy.com
  • API Key — Generated from the dashboard
  • Frihet Pro or higher

Connect Lemon Squeezy with Frihet​

Step 1: Get your API Key​

  1. Go to app.lemonsqueezy.com/settings/api
  2. Log in to your account
  3. Click on Create API key (or the "+" button)
  4. Give it a name (e.g., "Frihet ERP")
  5. Copy the generated API Key
Save the key

The API Key is only shown once when created. Copy it before closing the window.

Step 2: Configure in Frihet​

  1. Go to Settings → Integrations
  2. Find Lemon Squeezy
  3. Click on Connect
  4. Paste your API Key
  5. Click on Verify connection
  6. If successful, Frihet will load your available stores
  7. (Optional) Select a specific store from the dropdown — if you don't select any, products and orders from all your stores will be imported
  8. Click on Save connection

Step 3: Verify connection​

  1. Frihet will display a summary of your store:
    • Store name
    • Number of products
    • Recent orders
  2. Perform a test import

How it works​

Frihet uses the Lemon Squeezy API with JSON:API format:

  1. You provide your API Key
  2. Frihet sends the key in the Authorization: Bearer <api-key> header
  3. Responses follow the JSON:API format (with data, attributes, relationships)
  4. Products and orders are imported on demand
  5. Deduplication is based on the Lemon Squeezy order ID (prefix LS-{id})
  6. The API Key is stored encrypted (AES-256-GCM) in Frihet

Synchronized Data​

DataDirectionFrequency
ProductsLemon Squeezy → FrihetOn demand
OrdersLemon Squeezy → FrihetOn demand
Buyer dataLemon Squeezy → FrihetWith each order
Amount and currencyLemon Squeezy → FrihetWith each order
Order statusLemon Squeezy → FrihetWith each import

Merchant of Record​

Lemon Squeezy acts as the Merchant of Record, which means that:

  • Lemon Squeezy charges the client, manages VAT/Sales Tax, and issues the invoice to the buyer
  • You receive the net amount (after taxes and commissions)
  • Frihet records the net revenue you receive for your internal accounting

This simplifies your accounting: you don't need to calculate international taxes for each digital sale.

Use Cases​

Indie Developer with SaaS​

You sell licenses for your software through Lemon Squeezy. Each payment is imported into Frihet as revenue, including both one-time payments and subscription renewals.

Plugin or Theme Creator​

You sell WordPress plugins, Shopify themes, or extensions. Frihet consolidates this revenue with the rest of your invoicing (consulting services, other clients).

Subscription Tracking​

You have a SaaS product with monthly and annual plans. From Frihet, you can see the breakdown of recurring revenue imported from Lemon Squeezy along with the rest of your business.

Import products​

  1. Go to Settings → Integrations → Lemon Squeezy
  2. Click on Import products
  3. Frihet will fetch the products from your store

Data imported per product:

  • Name
  • Price
  • Type (one-time payment, subscription)
  • Status (published, draft)

Import orders​

  1. Go to Settings → Integrations → Lemon Squeezy
  2. Click on Import orders
  3. Select the date range
  4. Frihet will create revenue records for each order

Each imported order includes:

  • Order ID
  • Buyer name and email
  • Product purchased
  • Total and net amount
  • Currency
  • Order date
  • Status (completed, refunded, pending)

Automatic retries​

If an import fails due to a temporary error (timeout, server error), Frihet automatically retries up to 3 times with exponential waits (1s, 2s, 4s). You don't need to do anything — retries are transparent.

Troubleshooting​

"Authentication error"​

  • Verify that the API Key is correct and has not been revoked
  • Check that your Lemon Squeezy account is active
  • If you created a new API Key, update it in Frihet

"Orders are not imported"​

  • Check that you have orders in the selected date range
  • Verify that the API Key is not restricted to certain scopes
  • If your store is new, ensure there is at least one completed order

"Amounts do not match what I see in Lemon Squeezy"​

  • Frihet imports the amount you receive (net of taxes and Lemon Squeezy commissions)
  • The gross amount the buyer sees includes taxes managed by the MoR
  • Consult the breakdown in your Lemon Squeezy dashboard to confirm

"I want to disconnect"​

  1. Go to Settings → Integrations → Lemon Squeezy
  2. Click on Disconnect
  3. Optionally, revoke the API Key from your Lemon Squeezy dashboard

Next steps​