Squarespace Integration Setup

📋Before You Start

• Squarespace store on a Commerce Basic or Advanced plan (Business plan does not include API access)
• Squarespace account with Administrator access

🔧Setup Steps

1. 1
   Generate a Squarespace Developer API Key

   Log into your Squarespace account and go to your site's settings. Navigate to Settings → Developer API Keys. Click Generate Key. Give it a name like "Pythias Integration". Under Permissions, enable: Orders → Read/Write. Click Generate Key.
2. 2
   Copy the API Key

   After generation, Squarespace displays the API key once. Copy it immediately and store it securely. If lost, you must generate a new key.
3. 3
   Enter the API key in Pythias

   In Pythias, go to Admin → Integrations → Add New Integration → Squarespace. Paste your API Key into the field. Click Test Connection. Once verified, click Save.
4. 4
   Configure fulfillment settings

   Choose how Pythias updates Squarespace orders after shipping. The default is to set the fulfillment status to Fulfilled and include the tracking number. Squarespace will automatically send the customer their shipping notification email.

🔄What Gets Synced

• ✓New Squarespace orders in Pending status (pulled every 5 minutes)
• ✓Order line items, product IDs, variant IDs, quantities, and shipping address
• ✓Fulfillment status (order marked as Fulfilled in Squarespace)
• ✓Tracking number added to the Squarespace order

💡Tips & Troubleshooting

• ⚡Squarespace API keys are tied to your account — if you transfer site ownership, you may need to regenerate the key under the new owner account.
• ⚡The Developer API Keys feature is only available on Commerce plans. If you see a plan upgrade prompt, your current plan does not include API access.
• ⚡Squarespace product IDs and variant IDs in the API response may differ from what you see in the admin — Pythias maps these automatically during the initial connection test.