---
title: "Create"
method: POST
path: "/items/create/"
---

# Create

`POST /items/create/`

This endpoint locates an existing order using the specified place date, shipping, payment and customer parameters, adding an additional item to that order.  If no order exists with these parameters, it will create a new order and add an item for that order.

## Request body

- object
  - `merchant_id` string, required — Merchant ID
  - `customer_id` string, required — Customer ID
  - `shipping_id` string, required — Shipping address record ID
  - `payment_id` string, required — Payment record ID
  - `offer_id` string, required — Offer ID
  - `product_id` string, required — Product ID
  - `place_date` string, required — Date for order placement, should be in MM/DD/YYYY format
  - `quantity` integer, required — Number of items
  - `contexts` object — Items contexts as key:value

## Response `200`

200

- object
  - `order` string
  - `offer` unknown
  - `subscription` string
  - `product` string
  - `components` object[]
  - `subscription_component` string
  - `quantity` integer
  - `public_id` string
  - `product_attribute` unknown
  - `price` string
  - `extra_cost` string
  - `total_price` string
  - `one_time` boolean
  - `order_updated` string
  - `frozen` boolean
  - `first_placed` unknown

## Other responses

- `400` — 400
- `403` — 403

---

[API](https://skmtc.net/ordergroove/apis/ordergroove-restrpc.md) · [All operations](https://skmtc.net/ordergroove/apis/ordergroove-restrpc/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ordergroove/ordergroove-restrpc/versions/ba97e740d08c/schema)