Skip to content

E-Commerce

Squarespace
API integration

Ship E-Commerce features without building the integration. Full Squarespace API access via Proxy and 40+ MCP-ready tools for AI agents — extend models and mappings to fit your product.

Talk to us
Squarespace

Use Cases

Why integrate with Squarespace

Common scenarios for SaaS companies building Squarespace integrations for their customers.

01

Power multichannel inventory sync for Squarespace merchants

Offer your IMS or POS users real-time stock synchronization between Squarespace and other sales channels so they never oversell. Truto handles the Squarespace OAuth and API quirks so you can focus on your sync logic.

02

Ship a print-on-demand or dropshipping app for Squarespace stores

Let your users auto-publish products and variants to their Squarespace catalog, then fetch new orders and post tracking numbers back automatically. One integration via Truto unlocks the entire Squarespace merchant base.

03

Automate fulfillment and shipping workflows

3PLs and shipping platforms can pull pending Squarespace orders, create fulfillments with carrier and tracking data, and trigger buyer notifications — all without each customer needing a developer.

04

Drive loyalty, rewards, and promo code programs

Loyalty and marketing SaaS products can analyze Squarespace transaction and contact data to tier customers, then programmatically mint unique discount codes as rewards.

05

Build a commerce-aware CRM or marketing automation layer

Ingest Squarespace contacts, addresses, and transaction histories into your CRM or email/SMS platform to power segmentation, LTV scoring, and personalized campaigns for boutique merchants.

What You Can Build

Ship these features with Truto + Squarespace

Concrete product features your team can ship faster by leveraging Truto’s Squarespace integration instead of building from scratch.

01

Two-way order and fulfillment sync

Pull new Squarespace orders on a schedule and push back fulfillments with carrier, tracking number, and shipped line items using the order fulfillment endpoint.

02

Real-time inventory adjustments

Increment, decrement, or set absolute stock values for any Squarespace product variant to keep quantities aligned across every channel your users sell on.

03

Automated product catalog publishing

Create, update, and delete Squarespace products and variants — including uploading variant images and reordering product image positions — straight from your app.

04

Programmatic discount code generation

Issue personalized percentage or flat-amount promo codes on demand for loyalty rewards, win-back flows, or campaign-specific offers.

05

Unified customer and transaction insights

Sync Squarespace contacts, contact addresses, profiles, and transaction summaries to build LTV models, cohort reports, and segmented audiences.

06

Third-party order ingestion into Squarespace

Push offline, pop-up, or marketplace sales into Squarespace as third-party channel orders so merchants have one source of truth for revenue.

SuperAI

Squarespace AI agent tools

Comprehensive AI agent toolset with fine-grained control. Integrates with MCP clients like Cursor and Claude, or frameworks like LangChain.

list_all_squarespace_contact_addresses

Get address book. Returns paginated addresses for the contact. When there is at least one entry, exactly one is the default shipping address (defaultShippingAddressId and each entry's defaultShipping reflect this). The default shipping address (when present) is always included on the first page of results. Requires an API key with the CONTACT_READONLY or CONTACT permission.

create_a_squarespace_contact_address

Create address book entry. Creates a new address book entry for the contact. If this is the contact's only address book entry after creation, it becomes the default shipping address even when defaultShipping is false. Requires an API key with the CONTACT permission.

delete_a_squarespace_contact_address_by_id

Delete address book entry. Deletes the address book entry for the contact. If the deleted entry was the default shipping address, another entry is assigned as the default. Requires an API key with the CONTACT permission.

get_single_squarespace_contact_address_by_id

Get address book entry. Returns a single address book entry for the contact. Requires an API key with the CONTACT_READONLY or CONTACT permission.

update_a_squarespace_contact_address_by_id

Replace address book entry. Replaces an address book entry for the contact with a full JSON body. When updating the entry that is currently the default, setting "defaultShipping" from true to false has no effect. Requires an API key with the CONTACT permission.

list_all_squarespace_contacts

List contacts. Returns a paginated list of contacts for the website. Requires an API key with the CONTACT_READONLY or CONTACT permission.

create_a_squarespace_contact

Create contact. Creates a new contact. Requires an API key with the CONTACT permission.

squarespace_contacts_search

Query contacts. Returns a paginated list of contacts matching filters and sort options in the request body. Requires an API key with the CONTACT_READONLY or CONTACT permission.

delete_a_squarespace_contact_by_id

Delete contact. Deletes the contact for the given contact ID. Requires an API key with the CONTACT permission.

get_single_squarespace_contact_by_id

Get contact. Returns the contact for the given contact ID. Requires an API key with the CONTACT_READONLY or CONTACT permission.

update_a_squarespace_contact_by_id

Update contact. Updates a contact using JSON merge patch. Requires an API key with the CONTACT permission. Partial update (JSON merge patch): send only the fields to change.

list_all_squarespace_discounts

List discounts. Returns a paginated list of discounts for the website. Requires an API key with the DISCOUNTS_READONLY or DISCOUNTS permission.

create_a_squarespace_discount

Create discount. Creates a discount. A successful request returns the created Discount resource. Requires an API key with the DISCOUNTS permission. Example: trigger {type: CODE, promoCode}, template {type: PERCENTAGE, percentage: "10"}, criteria {type: ANY_ORDER}, validFrom.

delete_a_squarespace_discount_by_id

Delete discount. Deletes the discount for the given discount ID. Deletion is permitted for any discount owned by the website, including discounts whose criteria, template, or trigger types are not supported by this API version; no type validation is performed. Requires an API key with the DISCOUNTS permission.

get_single_squarespace_discount_by_id

Get discount. Returns the discount for the given discount ID. Requires an API key with the DISCOUNTS_READONLY or DISCOUNTS permission.

update_a_squarespace_discount_by_id

Update discount. Replaces the discount for the given discount ID. Requires an API key with the DISCOUNTS permission. Send the full discount without the read-only fields id, websiteId, lastRedeemedAt, numberOfUses and status, and with template.percentage as a string (the get returns it as a number).

list_all_squarespace_fulfillment_options

Get fulfillment options. Returns a list of fulfillment option IDs and carrier services that can be used with discounts. Requires an API key with the DISCOUNTS_READONLY or DISCOUNTS permission.

list_all_squarespace_inventory

List inventory. Retrieves real-time stock information for all product variants. Stock information is stored in an InventoryItem for each product variant. The response contains up to 50 InventoryItems and supports dynamic cursors for pagination.

get_single_squarespace_inventory_by_id

Get inventory. Retrieves real-time stock information for specific product variants. Stock information is stored in an InventoryItem and up to 50 InventoryItems can be retrieved per request.

create_a_squarespace_inventory_adjustment

Adjust stock quantities. Adjusts stock quantities for product variants. Stock quantities can be added or subtracted, set with a given number, or marked as "unlimited". All quantity information is stored in InventoryItems. The connector adds the required Idempotency-Key header (a new UUID per request).

list_all_squarespace_inventory_by_variant_ids

Get inventory. Retrieves real-time stock information for specific product variants. Stock information is stored in an InventoryItem and up to 50 InventoryItems can be retrieved per request. Returns all requested records.

create_a_squarespace_order_fulfillment

Fulfill order. Updates the status of a specific order to fulfilled, with options to include shipment information and send a customer notification.

list_all_squarespace_orders

List orders. Retrieves information about all orders. Orders can be filtered by Customer ID and date ranges. The response contains order information in an Order, up to 50 Orders ordered by their modification date (modifiedOn), and supports dynamic cursors for pagination. Squarespace rejects the cursor combined with other parameters: on later pages send only next_cursor.

create_a_squarespace_order

Create order. Creates an order using information from a third-party sales channel. A successful request creates an Order resource. The connector adds the required Idempotency-Key header (a new UUID per request). With an API key Squarespace allows 100 order creations per hour per site; orders are imported as third-party channel orders. shippingLines (method + amount) are required when shippingAddress is sent; set inventoryBehavior and shopperFulfillmentNotificationBehavior to SKIP to import without stock changes or customer e-mails. HTTP 401 means the key lacks Orders Read and Write.

get_single_squarespace_order_by_id

Get order. Retrieves information for a specific order. The response contains order information in an Order.

create_a_squarespace_product_image_position

Update product image order. Updates the ordering of a product image on the product details page.

list_all_squarespace_product_image_status

Get image processing status. Retrieves the processing status for an uploaded product image. A successful request indicates that a ProductImage is processing, ready, or in an error state.

delete_a_squarespace_product_image_by_id

Delete one product image

update_a_squarespace_product_image_by_id

Update product image. Updates information for a product image. Currently, the endpoint only supports updates to the alt text for an image.

create_a_squarespace_product_variant_image

Associate variant image. Assigns a product image to a product variant. Specifying imageId of null will delete the association.

create_a_squarespace_product_variant

Create product variant. Creates a variant of a product. Creating a variant for a physical or service product requires that the product already has at least one attribute. If the product has (or will have) more than one variant, the product needs variantAttributes (e.g. ["Size"]) and every variant an attributes object (e.g. {"Size": "M"}).

delete_a_squarespace_product_variant_by_id

Delete one product variant

update_a_squarespace_product_variant_by_id

Update product variant. Updates a variant of a product. The endpoint supports partial updates.

list_all_squarespace_products

List products. Retrieves information for products; products can be filtered within a date range and by product type. The response contains product information in a Product, up to 50 Products ordered by their modification date (modifiedOn), and supports dynamic cursors for pagination.

create_a_squarespace_product

Create product. Creates a product with appropriate subresources based on product type. Required: type (PHYSICAL, SERVICE, GIFT_CARD or DOWNLOAD), storePageId (see store_pages) and at least one variant with sku and pricing.basePrice {currency, value}. For several variants also send variantAttributes and per-variant attributes.

get_single_squarespace_product_by_id

Get products. Retrieves information for specific products, including information for any variants or images. Up to 50 products can be retrieved per request.

delete_a_squarespace_product_by_id

Delete specified product

update_a_squarespace_product_by_id

Update product. Updates information for a product. The endpoint supports partial updates.

list_all_squarespace_products_by_ids

Get products. Retrieves information for specific products, including information for any variants or images. Up to 50 products can be retrieved per request. Returns all requested records.

list_all_squarespace_profiles

List profiles. Retrieves all profiles; profiles can be filtered and sorted. The response contains up to 50 Profiles and supports dynamic cursors for pagination. Squarespace rejects the cursor combined with other parameters: on later pages send only next_cursor.

get_single_squarespace_profile_by_id

Get profiles. Retrieves information for specific profiles. The response contains a list of up to 50 Profiles. Multiple Profiles can be retrieved by providing a comma-separated list of profile ids.

list_all_squarespace_profiles_by_ids

Get profiles. Retrieves information for specific profiles. The response contains a list of up to 50 Profiles. Multiple Profiles can be retrieved by providing a comma-separated list of profile ids. Returns all requested records.

list_all_squarespace_store_pages

List store pages. Retrieves information for all store pages on the website. The response supports dynamic cursors for pagination.

squarespace_transaction_summaries_search

Retrieve transaction summaries grouped by contact Body: contactIds (1-1000 contact IDs) and groupBy: "contactId" (the vendor's error message names CONTACT_ID, but only contactId works).

list_all_squarespace_transactions

List transactions. Retrieves all financial transactions for orders and donations. Per order and donation, the response groups transactions into a Document, contains up to 50 Documents ordered by their modification date (modifiedOn), and supports dynamic cursors for pagination.

get_single_squarespace_transaction_by_id

Get transactions. Retrieves information for specific transaction Documents. The response contains up to 50 Documents. Multiple Documents can be retrieved by providing a comma-separated list of Document ids.

list_all_squarespace_transactions_by_ids

Get transactions. Retrieves information for specific transaction Documents. The response contains up to 50 Documents. Multiple Documents can be retrieved by providing a comma-separated list of Document ids. Returns all requested records.

list_all_squarespace_website

Retrieves basic details about the website that owns the provided API key or OAuth token

Why Truto

Why use Truto’s MCP server for Squarespace

Other MCP servers give you a static tool list for one app. Truto gives you a managed, multi-tenant MCP infrastructure across 1050+ integrations.

01

Auto-generated, always up to date

Tools are dynamically generated from curated documentation — not hand-coded. As integrations evolve, tools stay current without manual maintenance.

02

Fine-grained access control

Scope each MCP server to read-only, write-only, specific methods, or tagged tool groups. Expose only what your AI agent needs — nothing more.

03

Multi-tenant by design

Each MCP server is scoped to a single connected account with its own credentials. The URL itself is the auth token — no shared secrets, no credential leaking across tenants.

04

Works with every MCP client

Standard JSON-RPC 2.0 protocol. Paste the URL into Claude, ChatGPT, Cursor, or any MCP-compatible agent framework — tools are discovered automatically.

05

Built-in auth, rate limits, and error handling

Tool calls execute through Truto’s proxy layer with automatic OAuth refresh, rate-limit handling, and normalized error responses. No raw API plumbing in your agent.

06

Expiring and auditable servers

Create time-limited MCP servers for contractors or automated workflows. Optional dual-auth requires both the URL and a Truto API token for high-security environments.

How It Works

From zero to integrated

Start with Squarespace in a free sandbox, usually ready within one business day. No boilerplate, no maintenance burden.

01

Link your customer’s Squarespace account

Use Truto’s frontend SDK to connect your customer’s Squarespace account. We handle all OAuth and API key flows — you don’t need to create the OAuth app.

02

We handle authentication

Don’t spend time refreshing access tokens or figuring out secure storage. We handle it and inject credentials into every API request.

03

Call our API, we call Squarespace

Truto’s Proxy API is a 1-to-1 mapping of the Squarespace API. You call us, we call Squarespace, and pass the response back in the same cycle.

04

Unified response format

Every response follows a single format across all integrations. We translate Squarespace’s pagination into unified cursor-based pagination. Data is always in the result attribute.

FAQs

Common questions about Squarespace on Truto

Authentication, rate limits, data freshness, and everything else you need to know before you integrate.

How does authentication to Squarespace work through Truto?

Truto manages the Squarespace OAuth flow end-to-end. Your users click connect, authorize their Squarespace site, and Truto stores and refreshes the tokens — your app just calls Truto with a connection ID.

Which Squarespace resources can I read and write today?

The integration covers products and variants, product images, inventory and inventory adjustments, orders and fulfillments, transactions, contacts and contact addresses, profiles, discounts, store pages, fulfillment options, and website metadata.

Are there Squarespace API rate limits I should be aware of?

Yes. Squarespace enforces per-endpoint limits — for example, order creation is capped at 100 orders per hour per site. Truto surfaces rate-limit responses so your app can back off or queue accordingly.

Can I import external orders into a Squarespace store?

Yes. Using the create order endpoint you can push sales from pop-ups, marketplaces, or other channels into Squarespace as third-party channel orders, subject to Squarespace's per-site hourly limit.

How fresh is the data — do you support webhooks or polling?

The current Squarespace tools are request/response. Most customers poll endpoints like list orders, list inventory, and transaction summaries search on a schedule appropriate to their use case; Truto can orchestrate scheduled syncs for you.

Do you support all Squarespace product types?

The product endpoints support the product types Squarespace exposes via its Commerce API, including physical, digital, service, and gift card products, along with variant-level image and inventory management.

Is there a Unified E-Commerce API for Squarespace?

Not yet — today you work directly with Squarespace-native endpoints through Truto, which keeps the full fidelity of Squarespace's data model. A unified e-commerce schema can be built on request if you need to normalize across multiple storefronts.

Squarespace

Get Squarespace integrated into your app

Our team understands what it takes to make a Squarespace integration successful. A short, crisp 30 minute call with folks who understand the problem.