Skip to content
Cobalz Affiliate

Squarespace integration (beta)

Beta:Squarespace doesn't expose an order-webhook for third-party apps in its standard plan tier. We support Squarespace via the Orders API (poll-based) plus inbound webhooks from a Squarespace Code Block on the order-confirmation page.

Inbound webhook receiver

Cobalz exposes POST /api/squarespace/webhook/<merchant_id> accepting Squarespace order events posted from a Code Block on your order-confirmation page.

POST https://affiliate.cobalz.com/api/squarespace/webhook/<merchant_id>
Content-Type: application/json
X-Cobalz-Signature: t=<unix>,v1=<base64-hmac>

{
  "event": "order.completed",
  "order": {
    "id": "<squarespace_order_id>",
    "grandTotal": { "value": 100, "currency": "USD" },
    "customerEmail": "alice@example.com",
    "couponCode": "ALICE10"
  }
}

Or use the Orders API (polling)

For Squarespace plans with API access (Commerce Advanced and above):

  • Generate a Squarespace API key with orders.read scope.
  • Paste it at Settings → Store connection → Squarespace API key.
  • We poll GET /1.0/commerce/orders every 5 minutes for new orders + refunds.

Tracker

Squarespace lets you inject custom JavaScript via Settings → Advanced → Code Injection → Footer. Paste the t.js snippet there.

Current limitations

  • No auto-coupon creation: Squarespace coupons are managed via the Squarespace admin only.
  • Refunds: Squarespace doesn't expose refund-level details in its API. If you poll, we detect refunded orders but the refund amount is the full grand total.
  • Real-time: only the Code Block path gives sub-minute attribution. Polling is at most 5-minute fresh.

OAuth + a full Squarespace App listing is on the roadmap. Track progress at our changelog.