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

# Order Updated Webhook

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

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

The order.updated event is triggered whenever an order's status changes. This is the
recommended webhook for tracking order status changes.

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

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

## Request body

- OrderUpdatedWebhookSchema
  - `id` integer, required — ID of the webhook message
  - `event` 'order.updated', required — Event type of webhook message
  - `timestamp` string, date-time — UTC timestamp when the event was created
  - `message` GetOrderSchema, required
    - `order_items` OrderItemSchema[], required — List of order items
      - `return_tracking_key` string, nullable, required
      - `shipment_tracking_key` string, nullable, required
      - `sku` string, required — SKU of the product variant
      - `status` 'open' | 'shipped' | 'cancelled' | 'returned', required
      - `id` integer, nullable
      - `vat` number — The tax percentage
      - `price_without_tax` integer, required — Price of the product excluding tax in the smallest currency unit (e.g. cents for Euro)
      - `price_with_tax` integer, required — Price of the product including tax in the smallest currency unit (e.g. cents for Euro)
    - `order_number` string, required — Order number of the order
    - `carrier_key` string, required — Carrier key from the Carrier model.
    - `cost_without_tax` integer, required — Cost of the order without tax in the smallest currency unit (e.g. cents for Euro)
    - `cost_with_tax` integer, required — Cost of the order with tax in the smallest currency unit (e.g. cents for Euro)
    - `delivery_document_url` string, required
    - `status` 'open' | 'shipped' | 'cancelled' | 'returned' | 'mixed', required
    - `customer_key` string, required — Reference key of the customer (MAPI: customer_key)
    - `shop` integer, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `fulfillment_type` string — Fulfillment type
    - `payment_method` string, nullable — Payment method
    - `billing_street` string, required — Billing address
    - `billing_zip_code` string, required — Billing zip code
    - `billing_city` string, required — Billing city
    - `billing_country_code` string, required — Billing country code
    - `billing_recipient_gender` string, nullable — Gender of the recipient
    - `billing_recipient_first_name` string, required — First name of the recipient
    - `billing_recipient_last_name` string, required — Last name of the recipient
    - `billing_additional` string, nullable — Additional billing information
    - `shipping_street` string, nullable — Shipping address
    - `shipping_zip_code` string, nullable — Shipping zip code
    - `shipping_city` string, nullable — Shipping city
    - `shipping_country_code` string, nullable — Shipping country
    - `shipping_additional` string, nullable — Additional shipping information
    - `shipping_collection_point_key` string, nullable — Shipping collection point key
    - `shipping_collection_point_type` string, nullable — Shipping collection point type
    - `shipping_collection_point_description` string, nullable — Shipping collection point description
    - `customer_phone` string, nullable — Customer phone number for collection point delivery notifications
    - `customer_email` string, nullable — Customer email address for collection point delivery notifications
    - `shipping_recipient_gender` string, nullable — Gender of the recipient
    - `shipping_recipient_first_name` string, required — First name of the recipient
    - `shipping_recipient_last_name` string, required — Last name of the recipient
    - `currency_code` string, required — Currency code
  - `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)