---
title: "Stock Updated Webhook"
method: POST
path: "/api/v1/webhooks/stock-updated"
tags: ["Webhook Messages"]
---

# Stock Updated Webhook

`POST /api/v1/webhooks/stock-updated`

This is a dummy endpoint that demonstrates the webhook payload structure that will be sent
to webhook subscribers when a stock.updated event occurs.

The actual webhooks will be sent asynchronously to the URLs specified in the webhook subscriptions
that are subscribed to the stock.updated event type.

The webhook payload includes:
- id: ID of the webhook message
- event: The event type (stock.updated)
- timestamp: When the event occurred
- subscription_id: ID of the webhook subscription
- message: The stock data in the same format as the GET /stock endpoint

## Request body

- StockWebhookMessageSchema
  - `id` integer, required — ID of the webhook message
  - `event` 'stock.updated', required — Event type of webhook message
  - `timestamp` string, date-time — UTC timestamp when the event was created
  - `message` WebhookStockSchema[], required — Stock payload of the triggered event
    - `sku` string, required — Stock Keeping Unit identifier
    - `quantity` integer, nullable, required — Stock quantity of the product variant in the merchant's warehouse.
    - `quantity_fbm` integer, nullable, required — Stock quantity of the product variant in ABOUT YOU warehouses.
  - `subscription_id` integer, nullable — ID (integer) of this property

## Response `200`

OK

---

[API](https://skmtc.dev/aboutyou/apis/sellers-center-api.md) · [All operations](https://skmtc.dev/aboutyou/apis/sellers-center-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aboutyou/sellers-center-api/revisions/578d18d6e63c/schema)