Skip to main content

Stock Webhooks

1 events

Common headers

Every webhook request includes these headers:

x-holded-webhook-eventstring

Event name, e.g. invoice.create

x-holded-webhook-datestring · ISO 8601

When the event was sent, e.g. 2026-06-18T11:10:35Z

x-holded-webhook-signaturestring

HMAC-SHA256 signature with the sha256= prefix (see below)

x-holded-webhook-idstring

Unique event identifier; use it as an idempotency key

x-holded-webhook-account-idstring

Identifier of the Holded account that triggered the event

x-holded-webhook-versionstring

Webhook system version (e.g. v1)

stock.updatePOST

Stock Updated

Sent when stock is updated for a product variant in Holded.

Payload

object

Stock data included in webhook payloads

productIdstring

Product unique identifier

variantIdstring

Product variant unique identifier

warehouseIdstring

Warehouse unique identifier

skustring

Stock Keeping Unit code

stockVariationnumber<float>

Stock quantity change (positive for additions, negative for removals)

calculatedStocknumber<float>

Total calculated stock across all warehouses after the update

calculatedVariantStocknumber<float>

Total calculated stock for this variant across all warehouses after the update

descriptionstring

Human-readable description of the stock movement

datestring

Date of the stock movement in ISO 8601 format

createdstring

Record creation timestamp in ISO 8601 format

actionstring | null

Action type that triggered the stock update (e.g. invoice_stock_update, manual_stock_update)

providerOriginChangestring | null

External provider that originated the change (e.g. shopify, woocommerce)

providerIdOriginChangestring | null

Identifier of the origin record in the external provider

idOriginChangestring | null

Identifier of the origin document in Holded

docHashstring | null

Document hash

hashstring | null

Movement hash

Example payload

json
{
  "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"
}