Skip to main content

Squarespace

Connection

Frihet stores your API Key and checks that Squarespace accepts it. Orders and products are imported when you click the button.

What Frihet does​

  • Stores your Squarespace API Key (stored encrypted). Frihet only asks for the API Key: there is no site to choose or confirm.
  • Test connection — Frihet checks the key against your Squarespace account.
  • Import orders — brings in the orders from your store and creates one invoice per order, with its lines (product, quantity and price paid).
  • Import products — brings in your store's whole catalog: name, description and price. The price is the one on the product's first variant. If you already have a product with the same name, it is skipped.
  • The client is created with the buyer's email, which is also used as the name. If you already have a client with that email, it is reused.

What Frihet does not do​

  • Import automatically or on a schedule: it only imports when you click the button.
  • Frihet does not record payment fees as expenses.
  • Filter orders by status: Frihet makes no distinction between pending, fulfilled, refunded or canceled orders.
  • Import product SKUs or variants: only the first variant's price is used.
  • Copy the buyer's address: the client is created with the address "N/A".
  • Avoid duplicate orders: repeating the import creates their invoices again.
  • Write to your Squarespace store.

Requirements​

  • A Squarespace Commerce store with access to developer API keys
  • A Squarespace API Key with read permission on orders and products
  • Each connected integration counts toward your plan limit: 2 on Free, 5 on Pro, unlimited on Premium.

Connect​

Step 1: get the API Key in Squarespace​

  1. Sign in to your Squarespace site
  2. Go to Settings → Advanced → Developer API Keys
  3. Click Generate API Key
  4. Give it a descriptive name, for example "Frihet ERP"
  5. Grant read permission on orders and products
  6. Copy the generated API Key

Step 2: save it in Frihet​

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

Import data​

  1. Go to Integrations, open Squarespace and go to the Data tab
  2. Click Import orders or Import products

Each time you click Import orders, Frihet reads every order in your store again and creates one invoice per order, including the ones you already imported. Import orders only once. Products are skipped if you already have one with the same name.

Imported data​

Squarespace fieldFrihet field
OrderInvoice
Order linesInvoice lines (product, quantity, price paid)
Buyer's emailClient (name = email)
ProductProduct (name, description, price)

Troubleshooting​

Connection error​

  • Check that the API Key is correct and has not been revoked
  • Check that your Squarespace store has access to the Commerce API
  • If you regenerated the API Key, update it on the Connection tab

Orders are not imported​

  • Check that the API Key has read permission on orders
  • Check that your store has orders in Squarespace

Products do not appear​

  • Check that the API Key has read permission on products
  • Products with the same name as one you already have in Frihet are skipped

Disconnect​

Orders and products already imported stay in Frihet. To disconnect, go to Integrations, open Squarespace and go to the Settings tab; there, click Disconnect Squarespace.

Next steps​

Last updated on