Order Backorder
Register this webhook using the name Backorder.
The webhook reports changes to the backordered quantity of an order’s line items. It is not limited to the first time an order becomes backordered.
For inventory-driven backorder recalculations, the webhook behaves as follows:
| Previous backorder quantity | New backorder quantity | Webhook sent |
|---|---|---|
0 | Greater than 0 | Yes |
Greater than 0 | A different value greater than 0 | Yes |
Greater than 0 | The same value | No |
0 | 0 | No |
Greater than 0 | 0 | May be sent during order allocation processing |
Order allocation processing can also send this webhook when it detects a backorder change, including when a line item is cleared and its current backorder_quantity is 0. Each payload contains the current state of every line item on the order, not only the line item that caused the notification. Use each line item’s backorder_quantity to determine its current backordered quantity.
Note
If a backorder changes during order allocation processing, integrations subscribed to the Order Allocated and Order Deallocated webhooks may receive separate notifications as allocations are created or removed. Order Allocated includes allocated line-item quantities; Order Deallocated identifies the removed allocation. Treat these webhooks as independent notifications and do not rely on their delivery order.
Webhook Body:
{
"account_id": 63898,
"account_uuid": "QWNjb3VudDo2Mzg5OA==",
"order_number": "SO-100045",
"order_id": 389118717,
"order_uuid": "T3JkZXI6Mzg5MTE4NzE3",
"partner_order_id": "shopify-5847291038",
"line_items": [
{
"id": 550365415,
"line_item_uuid": "TGluZUl0ZW06NTUwMzY1NDE1",
"partner_line_item_id": "shopify-line-128491",
"quantity": 4,
"backorder_quantity": 1,
"sku": "SHIRT-BLACK-M",
"is_kit_component": false,
"is_kit": false,
"updated_at": "2026-09-04T11:45:22",
"warehouse_id": 76733,
"warehouse_uuid": "V2FyZWhvdXNlOjc2NzMz"
},
{
"id": 550365416,
"line_item_uuid": "TGluZUl0ZW06NTUwMzY1NDE2",
"partner_line_item_id": "shopify-line-128492",
"quantity": 2,
"backorder_quantity": 0,
"sku": "HAT-NAVY-OS",
"is_kit_component": false,
"is_kit": false,
"updated_at": "2026-09-04T11:45:22",
"warehouse_id": 76733,
"warehouse_uuid": "V2FyZWhvdXNlOjc2NzMz"
}
],
"webhook_type": "Backorder"
}Response:
{
"code": "200",
"Message": "Success"
}