Skip to main content

Etsy

Available

This integration is available in Frihet. Configure it in Settings → Integrations → Etsy.

Connect your Etsy store to Frihet to automatically import orders, products, and buyer data. Etsy is the leading marketplace for handmade, vintage, and creative products, with over 90 million active buyers. With this integration, each sale in your Etsy store is recorded as income in Frihet, Etsy commissions are accounted for as expenses, and international sales are managed with automatic currency conversion.

What it's for​

  • Import orders — Each sale on Etsy is automatically converted into an income record in Frihet with all order details
  • Commissions and fees as expenses — Etsy listing, transaction, and processing fees are automatically recorded as expenses
  • Synchronized catalog — Your Etsy products are reflected in the Frihet catalog
  • Multi-currency — International sales are imported with their original currency and exchange rate
  • Imported clients — Etsy buyers are added as clients in Frihet with their shipping details

Requirements​

  • Active seller account on Etsy
  • Frihet Pro or Business Plan
  • Etsy API Key (obtained from the Etsy Developer Portal)

How to connect​

Step 1: Create an application on Etsy​

  1. Go to the Etsy Developer Portal
  2. Log in with your seller account
  3. Click on Create a New App
  4. Fill in the name ("Frihet ERP") and description
  5. Once the application is approved, copy the API Key (Keystring)

Step 2: Configure in Frihet​

  1. In Frihet, go to Settings → Integrations
  2. Search for Etsy and click on the card
  3. Paste your API Key in the corresponding field
  4. Click on Connect with Etsy to authorize access via OAuth
  5. Accept the requested permissions in the Etsy window
  6. Click on Save

Step 3: Initial import​

  1. Once connected, click on Import orders to retrieve the sales history
  2. Select the date range you want to import
  3. Review the imported orders and verify that the data is correct

Data synchronized​

DataDirectionDetails
OrdersEtsy → FrihetID, amount, date, products, shipping address
ProductsEtsy → FrihetName, price, quantity, variants
ClientsEtsy → FrihetBuyer name, email (if available), address
CommissionsEtsy → FrihetListing fees, transaction fees, payment processing fees as expenses
CurrencyEtsy → FrihetOriginal sale currency with exchange rate
Order statusEtsy → FrihetPaid, shipped, completed, refunded

Use cases​

Artisan with international sales​

You sell handmade jewelry on Etsy to buyers worldwide. Each sale is imported into Frihet with the original currency (USD, GBP, EUR) and the real exchange rate. Etsy commissions are automatically recorded as expenses, giving you a clear view of the actual margin for each sale. At the end of the quarter, you have all the data for your tax declaration.

Vintage product seller​

You manage a large catalog of vintage products on Etsy. Each sale updates your catalog in Frihet and records the income. You can generate profitability reports by product and see which product categories have a better margin after deducting Etsy commissions.

Digital creator with downloads​

You sell templates, illustrations, or digital resources on Etsy. Sales are imported automatically without manual intervention. Since there are no shipping costs for digital products, you can accurately track the net margin: sale price minus Etsy commissions.

Troubleshooting​

Connection error​

  • Verify that the API Key is correct and that the application is active in the Etsy Developer Portal
  • Check that the OAuth authorization has not expired — reconnect from Settings if necessary
  • Ensure that your Etsy account is in good standing (not suspended or restricted)

Orders not importing​

  • Confirm that you have sales in the selected date range
  • Only orders with completed payment are imported — pending payments are excluded
  • If you have many orders, the import may take a few minutes — wait for it to complete

Commissions not recorded​

  • Commissions are imported as separate expenses, associated with the corresponding order
  • Verify that commission import is enabled in the integration settings
  • Etsy advertising commissions (Etsy Ads) are imported separately

Incorrect currency​

  • Frihet uses the original transaction currency on Etsy
  • If your accounting is in EUR and the sale was in USD, Frihet applies the exchange rate from the day of the transaction
  • You can manually adjust the exchange rate from the expense/income detail

Next steps​