---
title: "Order Placed"
method: POST
path: "order.placed"
tags: ["Order Events"]
---

# Order Placed

`POST order.placed` (webhook)

Fired when a new order is successfully placed and paid.

## 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` ComFourthwallOpenapiModelOrderV1, required
    - `id` string
    - `shopId` string
    - `friendlyId` string
    - `checkoutId` string
    - `promotionId` string
    - `status` 'CONFIRMED' | 'PARTIALLY_IN_PRODUCTION' | 'IN_PRODUCTION' | 'PARTIALLY_SHIPPED' | 'SHIPPED' | 'PARTIALLY_DELIVERED' | 'DELIVERED' | 'CANCELLED' | 'COMPLETED'
    - `email` string
    - `emailMarketingOptIn` boolean
    - `username` string
    - `message` string
    - `amounts` ComFourthwallOpenapiModelOrderV1OrderAmounts
      - `subtotal` Money
        - `value` number, required
        - `currency` string, required
      - `shipping` Money
        - `value` number, required
        - `currency` string, required
      - `tax` Money
        - `value` number, required
        - `currency` string, required
      - `donation` Money
        - `value` number, required
        - `currency` string, required
      - `discount` Money
        - `value` number, required
        - `currency` string, required
      - `giftCards` ComFourthwallOpenapiModelOrderV1GiftCard[]
        - `code` string
        - `amountUsed` Money
          - `value` number, required
          - `currency` string, required
      - `total` Money
        - `value` number, required
        - `currency` string, required
    - `billing` ComFourthwallOpenapiModelOrderV1Billing
      - `address` ComFourthwallOpenapiModelAddress
        - `name` string
        - `address1` string
        - `address2` string
        - `city` string
        - `state` string
        - `country` string
        - `zip` string
        - `phone` string
    - `shipping` ComFourthwallOpenapiModelOrderV1Shipping
      - `address` ComFourthwallOpenapiModelAddress
        - `name` string
        - `address1` string
        - `address2` string
        - `city` string
        - `state` string
        - `country` string
        - `zip` string
        - `phone` string
    - `offers` ComFourthwallOpenapiModelOfferAbstractV1OfferOrderV1[]
      - `id` string
      - `name` string
      - `slug` string
      - `description` string
      - `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
        - `id` string
        - `name` string
        - `sku` string
        - `unitPrice` Money
          - `value` number, required
          - `currency` string, required
        - `unitCost` Money
          - `value` number, required
          - `currency` string, required
        - `compareAtPrice` Money
          - `value` number, required
          - `currency` string, required
        - `attributes` ComFourthwallOpenapiModelOfferAbstractV1OfferVariantAbstractV1Attributes
          - `description` string, required
          - `color` ComFourthwallOpenapiModelOfferAbstractV1OfferVariantAbstractV1AttributesColor
            - `name` string, required
            - `swatch` string, required
          - `size` ComFourthwallOpenapiModelOfferAbstractV1OfferVariantAbstractV1AttributesSize
            - `name` string, required
        - `quantity` integer
        - `price` Money
          - `value` number, required
          - `currency` string, required
        - `cost` Money
          - `value` number, required
          - `currency` string, required
        - `weight` ComFourthwallOpenapiModelOfferAbstractV1OfferVariantAbstractV1Weight
          - `value` number, required
          - `unit` string, required
        - `dimensions` ComFourthwallOpenapiModelOfferAbstractV1OfferVariantAbstractV1Dimensions
          - `length` number, required
          - `width` number, required
          - `height` number, required
          - `unit` string, required
    - `source` ComFourthwallOpenapiModelOrderV1Source
      - `type` 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
    - `updatedAt` string, date-time

## Acknowledgement `200`

Event received successfully

---

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