Zikkio

Squarespace catalogs and prices, through one API

Read products and variants from Squarespace Commerce and write variant prices, sale prices included. The site owner authorizes your extension once.

Squarespace Commerce APIs

At a glance

Connects with
Your OAuth extension
Merchant
Authorizes the extension, 2 clicks
Access
Renewed by Zikkio every 30 minutes
Reads
Catalog and variants
Writes
Prices and sale prices
Inventory
Write, per variant

What you can read and write

Every field comes back in the same shape as on the other platforms.

Data What you get Access
Catalog What you get: Every product of the site, physical and digital. Gift cards are left out. Access: Read
Variants What you get: Every variant, one row each. A digital product is one row. Access: Read
Prices What you get: Base price and sale price of each variant, with the sale turned on or off. Access: Write
Inventory What you get: Stock per variant, or unlimited. Access: Write

How a store connects

The site owner authorizes your extension once. Zikkio renews the tokens from then on.

  1. Your product creates a connect session for Squarespace
  2. The site owner opens the link and logs in to Squarespace
  3. They allow your extension on the site
  4. Zikkio stores the tokens and the site shows up as connected

Start the connection from your product

POST /v1/connect/sessions
curl -X POST https://api.zikkio.com/v1/connect/sessions \
  -H "Authorization: Bearer zk_test_••••" \
  -d '{ "platform": "squarespace" }'
201 Created
{ "connect_url": "https://connect.zikkio.com/s/ses_3kd9" }

What Zikkio handles on Squarespace

The platform details your integration does not have to deal with.

Rotating tokens

Access tokens last 30 minutes and the refresh token changes at every renewal. Zikkio renews them one call at a time, so no renewal cancels another.

Sale prices

Each variant has a base price and a sale price. Zikkio writes both and turns the sale on or off with them.

Paced writes

Squarespace takes one variant at a time and answers 429 when calls come too fast. Zikkio waits as long as it asks and carries on.

Squarespace questions

Before you connect the first Squarespace store.

Do tokens expire?
The access token lasts 30 minutes and the refresh token 7 days from its last renewal. Zikkio renews both with every catalog update, every 24 hours.
Are digital products and gift cards included?
Digital products are, one row each, without an SKU. Gift cards are left out.
What if the site disconnects the extension?
The connection stops working and your webhook is told. When the site owner authorizes the extension again, the same connection comes back.
What does it cost to connect Squarespace stores?
Nothing per store: every plan, the free one included, connects as many stores as you need. Plans differ only in API calls a month. Current prices are on the Pricing page.
Does the same code work on the other platforms?
Yes. The request is the same on all ten platforms; only the connection ID changes. The Platforms page shows what Zikkio reads and writes on each one.

Connect your first store today.

Free plan with 5,000 API calls a month and unlimited stores. No card, and no sales call unless you ask for one.

POST /v1/connect/sessions
curl -X POST https://api.zikkio.com/v1/connect/sessions \
  -H "Authorization: Bearer zk_test_••••" \
  -d '{ "platform": "shopify" }'
201 Created
{ "connect_url": "https://connect.zikkio.com/s/ses_3kd9" }