> ## 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 master catalog product.
Creates a shared master product that sellers can be made eligible to sell.
Pass `seller_ids` to set which sellers may sell the product. The `attributes` array accepts a unified input: reference an existing catalog attribute by `id`, or create an inline product-scoped attribute by `title`.
## Body parameters
Product title.
Product subtitle.
Product description.
Unique URL-safe handle, generated from the title if omitted.
One of `draft`, `proposed`, `published`, `rejected`.
Whether the product is a gift card.
Whether discounts can apply to the product.
URL of the product thumbnail.
Product images.
Image URL.
ID of the product in an external system.
ID of the product type.
ID of the collection to assign the product to.
IDs of sellers eligible to sell the product.
Categories to assign the product to.
Category ID.
Tags to assign to the product.
Tag ID.
Product options used to build variants.
Option title, for example `Size`.
Possible option values.
Unified attribute input — one of two shapes per item.
ID of an existing catalog attribute.
IDs of attribute values to select.
Scalar value for `text`, `unit`, or `toggle` attributes.
Attribute title.
One of `single_select`, `multi_select`, `unit`, `toggle`, `text`.
Value names to create and select.
Scalar value for non-select types.
Whether the attribute drives variant generation; only valid for `multi_select`.
Whether the attribute can be used as a storefront filter.
Whether a value is required on products.
Attribute description.
Custom key-value data.
Product variants.
Variant title.
Variant SKU.
Variant EAN.
Variant UPC.
Variant ISBN.
Variant ASIN.
Variant GTIN.
Variant barcode.
Harmonized System code.
Manufacturer identification code.
Sort rank of the variant.
Variant weight.
Variant length.
Variant height.
Variant width.
Country of origin.
Variant material.
Map of option title to option value, for example `{"Size": "M"}`.
Custom key-value data.
Product weight.
Product length.
Product height.
Product width.
Harmonized System code.
Manufacturer identification code.
Country of origin.
Product material.
Custom key-value data.
Custom data passed to workflow hooks.
## Response
The product's ID.
Product title.
Unique URL-safe handle.
One of `draft`, `proposed`, `published`, `rejected`.
Created variants.
Attribute values selected on the product.
Product-scoped (inline) attributes with their values.
Computed attribute groups with selected `values` and `all_values`.
Creation timestamp.
Last update timestamp.
```bash cURL theme={null}
curl -X POST 'http://localhost:9000/admin/products' \
-H 'Authorization: Bearer ' \
-H 'Content-Type: application/json' \
-d '{
"title": "Linen Shirt",
"seller_ids": ["sel_01HXYZABCDEF"],
"options": [{ "title": "Size", "values": ["S", "M"] }],
"variants": [
{ "title": "S", "sku": "LS-S", "options": { "Size": "S" } },
{ "title": "M", "sku": "LS-M", "options": { "Size": "M" } }
],
"attributes": [{ "title": "Material", "type": "single_select", "values": ["Linen"] }]
}'
```
```ts JS Client theme={null}
const { product } = await client.admin.products.mutate({
title: "Linen Shirt",
seller_ids: ["sel_01HXYZABCDEF"],
options: [{ title: "Size", values: ["S", "M"] }],
variants: [
{ title: "S", sku: "LS-S", options: { Size: "S" } },
{ title: "M", sku: "LS-M", options: { Size: "M" } },
],
attributes: [{ title: "Material", type: "single_select", values: ["Linen"] }],
})
```
```json 200 theme={null}
{
"product": {
"id": "prod_01HXYZABCDEF",
"title": "Linen Shirt",
"handle": "linen-shirt",
"status": "draft",
"variants": [
{ "id": "variant_01HXYZABCDEF", "title": "S", "sku": "LS-S" },
{ "id": "variant_01HXYZABCDEG", "title": "M", "sku": "LS-M" }
]
}
}
```