Sign in

v52

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-03269339953.6 KB
Ecommerce: Products

Create physical product

Create a published physical product with a single variant priced in the store currency.

post/api/ecommerce/v1/stores/{store_id}/products/physical

Path parameters

store_idstring required
Example:store_01J8Z5F8W9K8M4A7B3C2D1E0FG

The ID of the store to create the product in.

Request body

namestring required

The product name.

priceinteger required

Price in the smallest currency unit (e.g. cents). Must be positive.

descriptionstring nullable

The product description.

currencystring nullable

ISO 4217 currency code. Defaults to the store's default currency when omitted.

Example request

{
  "name": "My Product",
  "price": 1000,
  "description": "A great product.",
  "currency": "usd"
}

Response

Created response

admin_urlstring

Admin UI deep-link to manage the product.

Example response

{
  "product": {
    "id": "prod_01J8Z5F8W9K8M4A7B3C2D1E0FG",
    "title": "My Product",
    "type": "physical",
    "status": "published",
    "price": 1000,
    "currency_code": "usd"
  },
  "admin_url": "https://admin.example.com/store_01.../products/edit?product=prod_01..."
}