Prerequisites
The connector should already be set up, with a Connector Profile and a Linked Account. See Getting Started on the Unleashed connector page.Automatic webhook subscription
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.
Enable events in StackOne
Select the webhook events you want in StackOne. StackOne registers the Unleashed subscription with exactly those events.
Change or remove events
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.
Available webhook events
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.
Assembly events
Events related to assemblies.
- Assembly Updated (
assembly.updated) — Fired when an assembly is changed - Assembly Deleted (
assembly.deleted) — Fired when an assembly is deleted
Credit note events
Events related to credit notes.
- Credit Note Created (
creditnote.created) — Fired when a credit note is created - Credit Note Deleted (
creditnote.deleted) — Fired when a credit note is deleted
Customer events
Events related to customer records.
- Customer Created (
customer.created) — Fired when a customer is created - Customer Updated (
customer.updated) — Fired when a customer is changed - Customer Deleted (
customer.deleted) — Fired when a customer is deleted
Product events
Events related to products.
- Product Created (
product.created) — Fired when a product is created - Product Updated (
product.updated) — Fired when a product is changed - Product Deleted (
product.deleted) — Fired when a product is deleted
Purchase order events
Events related to purchase orders.
- Purchase Order Created (
purchaseorder.created) — Fired when a purchase order is created - Purchase Order Deleted (
purchaseorder.deleted) — Fired when a purchase order is deleted
Sales order events
Events related to sales orders.
- Sales Order Created (
salesorder.created) — Fired when a sales order is created - Sales Order Updated (
salesorder.updated) — Fired when a sales order is changed - Sales Order Deleted (
salesorder.deleted) — Fired when a sales order is deleted
Sales shipment events
Events related to sales shipments.
- Sales Shipment Created (
salesshipment.created) — Fired when a sales shipment is created - Sales Shipment Updated (
salesshipment.updated) — Fired when a sales shipment is changed - Sales Shipment Deleted (
salesshipment.deleted) — Fired when a sales shipment is deleted
Supplier return events
Events related to supplier returns.
- Supplier Return Created (
supplierreturn.created) — Fired when a supplier return is created - Supplier Return Updated (
supplierreturn.updated) — Fired when a supplier return is changed - Supplier Return Deleted (
supplierreturn.deleted) — Fired when a supplier return is deleted
Warehouse stock transfer events
Events related to warehouse stock transfers.
- Warehouse Stock Transfer Updated (
warehousetransfer.updated) — Fired when a warehouse stock transfer is changed - Warehouse Stock Transfer Deleted (
warehousetransfer.deleted) — Fired when a warehouse stock transfer is deleted
Delivery format
Details of how Unleashed delivers events to StackOne.
Fetch the full record
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).
Handle duplicate deliveries
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.