Back to Webhooks →

1 events

Common headers

Every webhook request includes these headers:

x-alladdin-webhook-event string

Event name, e.g. invoice.create

x-alladdin-webhook-date string · ISO 8601

x-alladdin-webhook-signature string

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

x-alladdin-webhook-id string

Unique event identifier; use it as an idempotency key

x-alladdin-webhook-account-id string

Identifier of the Alladdin account that triggered the event

x-alladdin-webhook-version string

Webhook system version (e.g. v1)

stock.update POST

Stock Updated

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

Payload

object

Stock data included in webhook payloads

productId string

Product unique identifier

variantId string

Product variant unique identifier

warehouseId string

Warehouse unique identifier

sku string

Stock Keeping Unit code

stockVariation number<float>

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

calculatedStock number<float>

Total calculated stock across all warehouses after the update

calculatedVariantStock number<float>

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

description string

Human-readable description of the stock movement

date string

Date of the stock movement in ISO 8601 format

created string

Record creation timestamp in ISO 8601 format

action string | null

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

providerOriginChange string | null

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

providerIdOriginChange string | null

Identifier of the origin record in the external provider

idOriginChange string | null

Identifier of the origin document in Alladdin

docHash string | null

Document hash

hash string | null

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