Squarespace doesn't have an app installation screen like Shopify. The connection uses an API key you generate in your site settings and paste into Furgox. The only tricky part is permissions: Squarespace sets them to “Read only” by default and, once the key is created, they can't be changed.
Before you start
You need a Squarespace commerce plan: without it, the developer API keys option doesn't appear.
You must log in as the site owner or an administrator.
A store can only be connected to one Furgox account at a time.
1. Generate the key in Squarespace
In your site's dashboard, go to Settings → Advanced → Developer API Keys.
Click Generate key and give it a name you'll recognise, for example
Furgox.Choose Read and write for the Orders, Inventory and Products permissions (if the last one appears). Each permission has its own dropdown.
Copy the key before closing the window.
The two classic mistakes: leaving a permission on “Read only” and closing the window without copying the key. Squarespace only shows it once and doesn't let you change its permissions later: in both cases, the fix is to generate a new key.
If the Products permission doesn't appear in the list, that's fine: not every site offers it and we build your catalogue from the inventory. The only difference is that your products come in without a photo until an order includes them.
2. Paste the key into Furgox
In your panel, open Integrations, click Connect a store and choose Squarespace.
Paste the key into API key and click Connect with Squarespace. You don't need to enter your store address: the key already identifies it.
Before saving anything we check that the key can read your orders, inventory and products, and write to the inventory. If something's missing, we tell you what. What Squarespace doesn't let us check at that point is write access on Orders: if you left it on “Read only”, the connection works but we won't be able to mark your orders as shipped, and you'll notice when the first order goes out. That's why it matters so much to get it right in step 1.
3. Done: your store is connected
What happens from now on
Orders
Squarespace doesn't let us be notified of its changes when the connection uses an API key, so we poll your store every 15 seconds. In practice an order shows up in Furgox within seconds.
If you'd rather review each order before it's prepared, turn on Accept the orders myself on the store card.
Products
We import your catalogue with its variants, SKU and photo. When you include a product in its first inbound it gets its Furgox SKU, which we also write into your Squarespace. More in What we do with your catalogue.
Stock
We publish the real warehouse units back to Squarespace as goods arrive and orders go out.
Shipping
When the order ships we write the tracking number into Squarespace and mark it as fulfilled, so your customer gets Squarespace's shipping notification.
What Squarespace doesn't let us do
Their API offers no refunds, cancellations or order editing. If you need to cancel or refund an order, do it from Squarespace: we handle the physical side of the shipment.
If something goes wrong
“The API key is missing permissions”
A key's permissions can't be changed. Generate a new one under Settings → Advanced → Developer API Keys with Read and write on each section and connect again with it.
Orders stay pending in my Squarespace
That's the typical symptom of having Orders on “Read only”: we can read them but not mark them as shipped. Generate a new key with the right permission and connect it as explained just below.
I've regenerated or deleted the key in Squarespace
The old key stops working, we stop syncing and, within a few minutes, the card turns to Disconnected on its own. Click Reconnect on the card, or go to Connect a store → Squarespace and paste the new key: the store you already had is updated, with no orders or history lost. What each button on the card does is explained in Sync, disconnect or delete a store.
“That store is already connected to another Furgox account”
The same store can't be in two Furgox accounts. If you think it's a mistake, write to us.
Stuck on the permissions? Write to us from the panel chat and we'll go through it with you.