---
title: "createReplenishmentOrder"
method: POST
path: "/awd/2024-05-09/replenishmentOrders"
tags: ["Amazon Warehousing and Distribution v2024-05-09"]
---

# createReplenishmentOrder

`POST /awd/2024-05-09/replenishmentOrders`

Creates an AWD replenishment order with given products to replenish.
The API will return the order ID of the newly created order and also start an async validation check on the products to e.
The order status will transition to ELIGIBLE/INELIGIBLE status from VALIDATING post validation check

## Request body

- ReplenishmentOrderCreationData — This structure represents the payload for creating an AFN Replenishment Order. By default, all replenishment orders created support Partial order preferences.
  - `preferences` ReplenishmentPreferences — Preferences that can be passed in context of a replenishment order
    - `confirmation` 'AUTO' | 'MANUAL' — Confirmation Modes supported for Replenishment order creation. By default, the confirmation mode will be set to MANUAL.
  - `products` DistributionProduct[] — Requested amount of single product units to be replenished.
    - `attributes` ProductAttribute[] — Attributes for this instance of the product, i.e. already-prepped, or other attributes that distinguish the product beyond the SKU.
      - `name` string — Product attribute name.
      - `value` string — Product attribute value.
    - `quantity` integer, required — Quantity of the product
    - `sku` string, required — The seller/merchant stock keeping unit (SKU).

## Response `201`

CreateReplenishmentOrder 201 response.

- ReplenishmentOrderReference — Response containing the reference identifier for the newly created/updated replenishment order consisting of the order ID.
  - `orderId` string, required — Order ID of the Replenishment order.

## Other responses

- `400` — Request has missing or invalid parameters and cannot be parsed.
- `403` — Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
- `404` — The resource specified does not exist.
- `413` — The request size exceeded the maximum accepted size.
- `415` — The request payload is in an unsupported format.
- `429` — The frequency of requests was greater than allowed.
- `500` — An unexpected condition occurred that prevented the server from fulfilling the request.
- `503` — Temporary overloading or maintenance of the server.

---

[API](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01.md) · [All operations](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/a-content-management-v2020-11-01/revisions/815a5b6dbaa6/schema)