> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mercurjs.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Create Product
> Create a new product owned by the seller.
Creates a product; when no status is provided it is created with status `proposed`.
When the product request flow is enabled, `status` may only be `draft` or `proposed` — publishing requires operator approval.
## Query parameters
Comma-separated fields to include in the returned product. Prefix with `+`/`-` to add to or remove from the defaults.
## Body parameters
The product's title.
The product's subtitle.
The product's description.
One of `draft`, `proposed`, `published`, `rejected`. Restricted to `draft` / `proposed` when the product request flow is enabled.
Whether the product is a gift card.
Whether discounts can apply to the product.
Image URL.
URL of the product's thumbnail image.
The product's URL handle; generated from the title when omitted.
ID of the product in an external system.
ID of the product type.
ID of the collection the product belongs to.
Category ID.
Tag ID.
Option title, e.g. `Size`.
Allowed option values.
Product attribute assignments; each entry references an existing attribute by `id` or defines one inline by `title`.
Existing attribute ID (referencing form).
IDs of attribute values to select (referencing form).
Scalar value for `text`, `unit`, or `toggle` attributes.
Attribute title (inline form).
One of `single_select`, `multi_select`, `text`, `toggle`, `unit` (inline form).
Value names to create and select (inline form).
Whether the attribute drives variant combinations (inline form).
Whether the attribute is filterable (inline form).
Whether the attribute is required (inline form).
Attribute description (inline form).
Custom key-value pairs (inline form).
Variant title.
Variant SKU.
EAN barcode.
UPC barcode.
ISBN code.
Amazon ASIN.
GTIN code.
Generic barcode.
Harmonized System code.
Manufacturer ID code.
Sort rank of the variant.
Weight of the variant.
Length of the variant.
Height of the variant.
Width of the variant.
Country of origin.
Material of the variant.
Custom key-value pairs.
Option title to value mapping, e.g. `{"Size": "M"}`.
Weight of the product.
Length of the product.
Height of the product.
Width of the product.
Harmonized System code.
Manufacturer ID code.
Country of origin.
Material of the product.
Custom key-value pairs.
Extra data passed to workflow hooks.
## Response
The product's ID.
The product's title.
The product's status (`proposed` unless overridden).
The product's URL handle.
The created variants.
The product's attribute assignments.
```bash cURL theme={null}
curl -X POST 'http://localhost:9000/vendor/products' \
-H 'Authorization: Bearer ' \
-H 'x-seller-id: ' \
-H 'Content-Type: application/json' \
-d '{
"title": "Acme T-Shirt",
"options": [{ "title": "Size", "values": ["S", "M"] }],
"variants": [
{ "title": "S", "sku": "ACME-SHIRT-S", "options": { "Size": "S" } },
{ "title": "M", "sku": "ACME-SHIRT-M", "options": { "Size": "M" } }
]
}'
```
```ts JS Client theme={null}
const { product } = await client.vendor.products.mutate({
title: "Acme T-Shirt",
options: [{ title: "Size", values: ["S", "M"] }],
variants: [
{ title: "S", sku: "ACME-SHIRT-S", options: { Size: "S" } },
{ title: "M", sku: "ACME-SHIRT-M", options: { Size: "M" } },
],
})
```
```json 201 theme={null}
{
"product": {
"id": "prod_01HXYZ",
"title": "Acme T-Shirt",
"status": "proposed",
"handle": "acme-t-shirt",
"variants": [
{ "id": "variant_01HXYZ", "title": "M", "sku": "ACME-SHIRT-M" }
]
}
}
```