Stock Webhooks
1 events
Common headers
Every webhook request includes these headers:
x-holded-webhook-eventstringEvent name, e.g. invoice.create
x-holded-webhook-datestring · ISO 8601When the event was sent, e.g. 2026-06-18T11:10:35Z
x-holded-webhook-signaturestringHMAC-SHA256 signature with the sha256= prefix (see below)
x-holded-webhook-idstringUnique event identifier; use it as an idempotency key
x-holded-webhook-account-idstringIdentifier of the Holded account that triggered the event
x-holded-webhook-versionstringWebhook system version (e.g. v1)
stock.updatePOSTStock Updated
Sent when stock is updated for a product variant in Holded.
Payload
Stock data included in webhook payloads
Product unique identifier
Product variant unique identifier
Warehouse unique identifier
Stock Keeping Unit code
Stock quantity change (positive for additions, negative for removals)
Total calculated stock across all warehouses after the update
Total calculated stock for this variant across all warehouses after the update
Human-readable description of the stock movement
Date of the stock movement in ISO 8601 format
Record creation timestamp in ISO 8601 format
Action type that triggered the stock update (e.g. invoice_stock_update, manual_stock_update)
External provider that originated the change (e.g. shopify, woocommerce)
Identifier of the origin record in the external provider
Identifier of the origin document in Holded
Document hash
Movement hash
Example payload
{
"productId": "string",
"variantId": "string",
"warehouseId": "string",
"sku": "string",
"stockVariation": 0,
"calculatedStock": 0,
"calculatedVariantStock": 0,
"description": "string",
"date": "string",
"created": "string",
"action": "string",
"providerOriginChange": "string",
"providerIdOriginChange": "string",
"idOriginChange": "string",
"docHash": "string",
"hash": "string"
}