---
title: "Order Updated"
method: POST
path: "ORDER_UPDATED"
tags: ["Order Events"]
---

# Order Updated

`POST ORDER_UPDATED` (webhook)

Fired when an order's status, shipping address, or email is updated.

## Payload

- object
  - `id` string, required — Unique identifier for this webhook event
  - `webhookId` string, required — ID of the webhook configuration that triggered this event
  - `shopId` string, required — ID of the shop that generated this event
  - `type` string, required — The event type
  - `apiVersion` string, required — API version of the webhook payload
  - `createdAt` string, date-time, required — When this event was created
  - `testMode` boolean, required — Whether this event was sent in test mode
  - `data` ComFourthwallOpenapiModelOrderUpdatedV1, required
    - `order` ComFourthwallOpenapiModelOrderV1
      - `id` string, required
      - `shopId` string, required
      - `friendlyId` string, required
      - `checkoutId` string, required
      - `promotionId` string
      - `status` 'CONFIRMED' | 'PARTIALLY_IN_PRODUCTION' | 'IN_PRODUCTION' | 'PARTIALLY_SHIPPED' | 'SHIPPED' | 'PARTIALLY_DELIVERED' | 'DELIVERED' | 'CANCELLED' | 'COMPLETED', required
      - `email` string, required
      - `emailMarketingOptIn` boolean, required
      - `username` string
      - `message` string, required
      - `amounts` ComFourthwallOpenapiModelOrderV1OrderAmounts, required
        - `subtotal` Money, required
          - `value` number, required
          - `currency` string, required
        - `shipping` Money, required
          - `value` number, required
          - `currency` string, required
        - `tax` Money, required
          - `value` number, required
          - `currency` string, required
        - `donation` Money, required
          - `value` number, required
          - `currency` string, required
        - `discount` Money, required
          - `value` number, required
          - `currency` string, required
        - `giftCards` ComFourthwallOpenapiModelOrderV1GiftCard[], required
          - `code` string, required
          - `amountUsed` Money, required
            - `value` number, required
            - `currency` string, required
        - `total` Money, required
          - `value` number, required
          - `currency` string, required
      - `billing` ComFourthwallOpenapiModelOrderV1Billing
        - `address` ComFourthwallOpenapiModelAddress, required
          - `name` string, required
          - `address1` string, required
          - `address2` string
          - `city` string, required
          - `state` string, required
          - `country` string, required
          - `zip` string
          - `phone` string
      - `shipping` ComFourthwallOpenapiModelOrderV1Shipping
        - `address` ComFourthwallOpenapiModelAddress, required
          - `name` string, required
          - `address1` string, required
          - `address2` string
          - `city` string, required
          - `state` string, required
          - `country` string, required
          - `zip` string
          - `phone` string
      - `offers` ComFourthwallOpenapiModelOfferAbstractV1OfferOrderV1[], required
        - `id` string, required
        - `name` string, required
        - `slug` string, required
        - `description` string, required
        - `primaryImage` ComFourthwallOpenapiModelImage
          - `id` string, required
          - `url` string, required
          - `width` integer, required — The original width of the image in pixels.
          - `height` integer, required — The original height of the image in pixels.
          - `transformedUrl` string, required — Transformed URL with applied image processing (e.g., resizing, optimization)
        - `variant` ComFourthwallOpenapiModelOfferAbstractV1OfferVariantAbstractV1OfferVariantWithQuantityV1, required
          - `id` string, required
          - `name` string, required
          - `sku` string, required
          - `unitPrice` Money, required
            - `value` number, required
            - `currency` string, required
          - `unitCost` Money
            - `value` number, required
            - `currency` string, required
          - `compareAtPrice` Money
            - `value` number, required
            - `currency` string, required
          - `attributes` ComFourthwallOpenapiModelOfferAbstractV1OfferVariantAbstractV1Attributes, required
            - `description` string, required
            - `color` ComFourthwallOpenapiModelOfferAbstractV1OfferVariantAbstractV1AttributesColor
              - …
            - `size` ComFourthwallOpenapiModelOfferAbstractV1OfferVariantAbstractV1AttributesSize
              - …
          - `quantity` integer, required
          - `price` Money, required
            - `value` number, required
            - `currency` string, required
          - `cost` Money
            - `value` number, required
            - `currency` string, required
          - `weight` ComFourthwallOpenapiModelOfferAbstractV1OfferVariantAbstractV1Weight, required
            - `value` number, required
            - `unit` string, required
          - `dimensions` ComFourthwallOpenapiModelOfferAbstractV1OfferVariantAbstractV1Dimensions, required
            - `length` number, required
            - `width` number, required
            - `height` number, required
            - `unit` string, required
      - `source` union, required
        - ComFourthwallOpenapiModelOrderV1SourceGiveawayLinks
          - `type` 'GIVEAWAY_LINKS', required
          - `giftId` string, required
        - ComFourthwallOpenapiModelOrderV1SourceOrder
          - `type` 'ORDER', required
        - ComFourthwallOpenapiModelOrderV1SourceSamplesOrder
          - `type` 'SAMPLES_ORDER', required
        - ComFourthwallOpenapiModelOrderV1SourceTwitchGiftRedemption
          - `type` 'TWITCH_GIFT_REDEMPTION', required
          - `giftPurchaseId` string, required
          - `giftId` string, required
      - `trackingParams` ComFourthwallOpenapiModelOrderV1TrackingParams
        - `fbc` string
        - `fbp` string
        - `utm_source` string
        - `utm_medium` string
        - `utm_campaign` string
        - `utm_content` string
        - `utm_term` string
      - `metadata` object — Custom metadata passed during cart creation. Null for orders without metadata.
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
    - `update` ComFourthwallOpenapiModelOrderUpdatedV1Update
      - `type` string, required

## Acknowledgement `200`

Event received successfully

---

[API](https://skmtc.net/fourthwall/apis/fourthwall-apis-2.md) · [All operations](https://skmtc.net/fourthwall/apis/fourthwall-apis-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fourthwall/fourthwall-apis-2/revisions/ef273312f051/schema)