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

# Unleashed Webhook Setup Guide

> Configure Unleashed 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/unleashed#getting-started) on the Unleashed connector page.

<section data-guide-section data-guide-scopes="">
  <h2>Automatic webhook subscription</h2>

  <p>StackOne creates and manages the Unleashed webhook subscription automatically. When webhook events are enabled for a connected account, StackOne creates one subscription in your Unleashed account with the API Id and API Key of the connection, subscribed to the events you enable. You don't need to configure anything in Unleashed.</p>

  <Steps>
    <Step title="Enable events in StackOne">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Select the webhook events you want in StackOne. StackOne registers the Unleashed subscription with exactly those events.</p>
      </div>
    </Step>

    <Step title="Change or remove events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Changing the event selection replaces the StackOne subscription with a new one for the updated event list. Disconnecting the account deletes the subscription, which stops deliveries.</p>
      </div>
    </Step>
  </Steps>
</section>

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

  <p>The following Unleashed events can be enabled. Only events selected in StackOne are included in the subscription — Unleashed will not deliver events that are not subscribed.</p>

  <Steps>
    <Step title="Assembly events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to assemblies.</p>

        <ul>
          <li><strong>Assembly Updated</strong> (`assembly.updated`) — Fired when an assembly is changed</li>
          <li><strong>Assembly Deleted</strong> (`assembly.deleted`) — Fired when an assembly is deleted</li>
        </ul>
      </div>
    </Step>

    <Step title="Credit note events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to credit notes.</p>

        <ul>
          <li><strong>Credit Note Created</strong> (`creditnote.created`) — Fired when a credit note is created</li>
          <li><strong>Credit Note Deleted</strong> (`creditnote.deleted`) — Fired when a credit note is deleted</li>
        </ul>
      </div>
    </Step>

    <Step title="Customer events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to customer records.</p>

        <ul>
          <li><strong>Customer Created</strong> (`customer.created`) — Fired when a customer is created</li>
          <li><strong>Customer Updated</strong> (`customer.updated`) — Fired when a customer is changed</li>
          <li><strong>Customer Deleted</strong> (`customer.deleted`) — Fired when a customer is deleted</li>
        </ul>
      </div>
    </Step>

    <Step title="Product events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to products.</p>

        <ul>
          <li><strong>Product Created</strong> (`product.created`) — Fired when a product is created</li>
          <li><strong>Product Updated</strong> (`product.updated`) — Fired when a product is changed</li>
          <li><strong>Product Deleted</strong> (`product.deleted`) — Fired when a product is deleted</li>
        </ul>
      </div>
    </Step>

    <Step title="Purchase order events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to purchase orders.</p>

        <ul>
          <li><strong>Purchase Order Created</strong> (`purchaseorder.created`) — Fired when a purchase order is created</li>
          <li><strong>Purchase Order Deleted</strong> (`purchaseorder.deleted`) — Fired when a purchase order is deleted</li>
        </ul>
      </div>
    </Step>

    <Step title="Sales order events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to sales orders.</p>

        <ul>
          <li><strong>Sales Order Created</strong> (`salesorder.created`) — Fired when a sales order is created</li>
          <li><strong>Sales Order Updated</strong> (`salesorder.updated`) — Fired when a sales order is changed</li>
          <li><strong>Sales Order Deleted</strong> (`salesorder.deleted`) — Fired when a sales order is deleted</li>
        </ul>
      </div>
    </Step>

    <Step title="Sales shipment events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to sales shipments.</p>

        <ul>
          <li><strong>Sales Shipment Created</strong> (`salesshipment.created`) — Fired when a sales shipment is created</li>
          <li><strong>Sales Shipment Updated</strong> (`salesshipment.updated`) — Fired when a sales shipment is changed</li>
          <li><strong>Sales Shipment Deleted</strong> (`salesshipment.deleted`) — Fired when a sales shipment is deleted</li>
        </ul>
      </div>
    </Step>

    <Step title="Supplier return events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to supplier returns.</p>

        <ul>
          <li><strong>Supplier Return Created</strong> (`supplierreturn.created`) — Fired when a supplier return is created</li>
          <li><strong>Supplier Return Updated</strong> (`supplierreturn.updated`) — Fired when a supplier return is changed</li>
          <li><strong>Supplier Return Deleted</strong> (`supplierreturn.deleted`) — Fired when a supplier return is deleted</li>
        </ul>
      </div>
    </Step>

    <Step title="Warehouse stock transfer events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to warehouse stock transfers.</p>

        <ul>
          <li><strong>Warehouse Stock Transfer Updated</strong> (`warehousetransfer.updated`) — Fired when a warehouse stock transfer is changed</li>
          <li><strong>Warehouse Stock Transfer Deleted</strong> (`warehousetransfer.deleted`) — Fired when a warehouse stock transfer is deleted</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

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

  <p>Details of how Unleashed delivers events to StackOne.</p>

  <Steps>
    <Step title="Fetch the full record">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Each event carries only the GUID of the changed record, which StackOne uses as the event ID. Unleashed sends it inside the `Data` field as a JSON-encoded string. To read the record itself, call the matching get action with that GUID (for example `get_sales_order` for a sales order event).</p>
      </div>
    </Step>

    <Step title="Handle duplicate deliveries">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Unleashed retries failed deliveries with exponential backoff for up to 72 hours, and the same event can be delivered more than once. Use the `EventNotificationId` in the event data to detect duplicates. Unleashed disables a subscription after 18 failed deliveries within 72 hours.</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.