> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Squarespace Webhook Setup Guide

> Configure Squarespace to deliver events to StackOne.

## Prerequisites

The connector should already be set up, with a Connector Profile and a Linked Account. See [Getting Started](/connectors/squarespace#getting-started) on the Squarespace connector page.

<section data-guide-section data-guide-scopes="">
  <h2>Subscribe via the StackOne dashboard</h2>

  <p>This connector uses <strong>Programmatic Webhooks</strong>. StackOne creates and manages the webhook subscription automatically when webhook events are enabled for a connected OAuth 2.0 account. No manual steps are needed in Squarespace.</p>

  <Steps>
    <Step title="Select event subscriptions in the dashboard">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the StackOne dashboard, open the Squarespace connector profile and enable the webhook events you want delivered. See <strong>Available webhook events</strong> below.</p>
      </div>
    </Step>

    <Step title="Registration on subscribe">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>StackOne calls `POST /1.0/webhook_subscriptions` with the connected account's OAuth token, creating one subscription for the connected site that covers exactly the events you enabled. Changing the selection re-creates the subscription, and disconnecting the account deletes it.</p>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Available webhook events</h2>

  <p>The following Squarespace events can be enabled.</p>

  <Steps>
    <Step title="Order events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events for commerce orders. Requires the `website.orders.read` scope.</p>

        <ul>
          <li><strong>Order Created</strong> (`order.create`) — fired when an order is created. Payment Plan orders fire only once fully paid.</li>
          <li><strong>Order Updated</strong> (`order.update`) — fired when an order is fulfilled, refunded, canceled, marked pending, or has its email changed.</li>
        </ul>
      </div>
    </Step>

    <Step title="Contact events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events for site contacts (customers, subscribers, and donors). Requires the `website.contacts` scope.</p>

        <ul>
          <li><strong>Contact Created</strong> (`contact.create`) — fired when a contact is created.</li>
          <li><strong>Contact Updated</strong> (`contact.update`) — fired when contact fields, email, marketing preference, or default address change.</li>
          <li><strong>Contact Deleted</strong> (`contact.delete`) — fired when a contact is removed.</li>
        </ul>
      </div>
    </Step>

    <Step title="Address events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events for contact address book entries. Requires the `website.contacts` scope.</p>

        <ul>
          <li><strong>Address Created</strong> (`address.create`) — fired when an address book entry is added.</li>
          <li><strong>Address Updated</strong> (`address.update`) — fired when an address book entry is changed.</li>
          <li><strong>Address Deleted</strong> (`address.delete`) — fired when an address book entry is removed.</li>
        </ul>
      </div>
    </Step>

    <Step title="Extension events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events about the StackOne OAuth app itself.</p>

        <ul>
          <li><strong>Extension Uninstalled</strong> (`extension.uninstall`) — fired when the site owner uninstalls the app. The account must be reconnected afterwards.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Delivery format</h2>

  <p>How Squarespace delivers events to StackOne.</p>

  <Steps>
    <Step title="One notification per event">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Squarespace posts each event as JSON with `id`, `websiteId`, `subscriptionId`, `topic`, `createdOn`, and a topic-specific `data` object. Delivery is at least once and unordered, so the same notification `id` can arrive more than once.</p>
      </div>
    </Step>

    <Step title="Retries">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Squarespace retries failed deliveries for up to 48 hours and may delete a subscription after repeated failures. StackOne answers every notification with `200 OK`.</p>
      </div>
    </Step>
  </Steps>
</section>

## Verify

Your Connector should now be able to receive and process events. Try triggering an event and you should see an Event appear in the Connector logs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.