---
title: Squarespace API Integration on Truto
slug: squarespace
category: E-Commerce
canonical: "https://truto.one/integrations/detail/squarespace/"
---

# Squarespace API Integration on Truto



**Category:** E-Commerce  
**Status:** Generally available

## MCP-ready AI tools

Truto exposes 48 tools for Squarespace that AI agents can call directly.

- **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

## How it works

1. **Link your customer's Squarespace account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app.
2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request.
3. **Call Truto's API to reach Squarespace.** The Proxy API is a 1-to-1 mapping of the Squarespace API.
4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field.

## Use cases

- **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.
- **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.
- **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.
- **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.
- **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

- **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.
- **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.
- **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.
- **Programmatic discount code generation** — Issue personalized percentage or flat-amount promo codes on demand for loyalty rewards, win-back flows, or campaign-specific offers.
- **Unified customer and transaction insights** — Sync Squarespace contacts, contact addresses, profiles, and transaction summaries to build LTV models, cohort reports, and segmented audiences.
- **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.

## FAQs

### 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.
