Skip to main content

Lemon Squeezy

Connection

From the Data tab, Frihet imports products and orders from the Lemon Squeezy store you connect. Frihet does not send anything to Lemon Squeezy.

What Frihet does​

  • Stores the Lemon Squeezy credentials you enter securely:
    • API Key (stored encrypted)
    • Store ID, required: Frihet imports only from that store.
  • Test connection — Frihet checks the API key with Lemon Squeezy.
  • Import products (Data tab) — creates one Frihet product for each product in the store, with name, description, price and the slug as SKU. If you already have a product with the same name, it is not duplicated.
  • Import orders (Data tab) — downloads the store's orders and creates one invoice for each:
    • Number LS-{order_number}, using the Lemon Squeezy order number.
    • A single line with quantity 1, the order's product name and the order total as Lemon Squeezy returns it. Frihet neither breaks down nor adds taxes (0% VAT).
    • Status: paid order, paid; pending, sent; anything else (refunded, failed...), draft.
    • The client is the buyer's name, with their email. If no client with that name exists, Frihet creates it.
  • If an invoice with the same number already exists, the order is skipped.

What Frihet does not do​

  • Import from all stores at once: you connect one store with its Store ID.
  • Import subscriptions or recurring charges: only products and orders.
  • Separate the tax or calculate net amounts: the invoice amount is the order total.
  • Filter orders by date.
  • Update already imported invoices when an order changes status later.
  • Import automatically or on a schedule: each import is one click on the button.

Requirements​

  • A Lemon Squeezy account with a store
  • The store's API Key and Store ID
  • Each connected integration counts toward your plan limit: 2 on Free, 5 on Pro, unlimited on Premium.

Connect​

Step 1: get the credentials in Lemon Squeezy​

  1. Sign in to Lemon Squeezy and open your account settings.
  2. In the API section, click Create API Key and copy the key.
  3. Copy your store's Store ID: it is the number shown in the Stores section of the settings.

Step 2: save them in Frihet​

  1. In Frihet, go to Integrations.
  2. Open Lemon Squeezy.
  3. On the Connection tab, paste the API Key and the Store ID.
  4. Click Test connection to verify.
  5. If the test succeeds, click Save connection.

Import data​

  1. Open the Data tab of the integration.
  2. Click Import products or Import orders.
  3. Review the created products and invoices.

Troubleshooting​

Connection error​

Check that the API key is copied correctly and has not been revoked in Lemon Squeezy. If you regenerated it, save the new one.

Orders are missing​

Frihet imports only the orders of the store whose Store ID you saved, and skips orders that already have an LS-{order_number} invoice.

Last updated on