Create Product Variant

POST

vendor

products

{id}

variants

curl -X POST 'http://localhost:9000/vendor/products/prod_01HXYZ/variants' \
  -H 'Authorization: Bearer <token>' \
  -H 'x-seller-id: <seller_id>' \
  -H 'Content-Type: application/json' \
  -d '{"title": "L", "sku": "ACME-SHIRT-L", "options": {"Size": "L"}}'

const { product_change } = await client.vendor.products.$id.variants.mutate({
  $id: "prod_01HXYZ",
  title: "L",
  sku: "ACME-SHIRT-L",
  options: { Size: "L" },
})

{
  "product_change": {
    "id": "prodch_01HXYZ",
    "product_id": "prod_01HXYZ",
    "status": "pending",
    "actions": [
      {
        "id": "prodchact_01HXYZ",
        "action": "VARIANT_ADD",
        "details": { "title": "L", "sku": "ACME-SHIRT-L" },
        "applied": false
      }
    ]
  }
}

Stages a VARIANT_ADD operation as a pending change request instead of creating the variant directly.

The endpoint responds with 202 Accepted and a product_change record; the variant appears on the product once the change is confirmed. The staged variant is always created with manage_inventory: false. Stock is tracked on offers.

Path parameters

string

required

The product’s ID.

Body parameters

string

required

The variant’s title.

string

The variant’s SKU.

string

EAN barcode.

string

UPC barcode.

string

ISBN code.

string

Amazon ASIN.

string

GTIN code.

string

Generic barcode.

string

Harmonized System code.

string

Manufacturer ID code.

number

Sort rank of the variant.

number

Weight of the variant.

number

Length of the variant.

number

Height of the variant.

number

Width of the variant.

string

Country of origin.

string

Material of the variant.

boolean

Whether backorders are allowed.

boolean

Accepted in the body but forced to false when the change is staged.

string

Variant thumbnail URL.

object

Custom key-value pairs.

object

Option title to value mapping, e.g. {"Size": "L"}.

Response

object

Show properties

string

The change request’s ID.

string

ID of the product the change targets.

string

One of pending, confirmed, declined, canceled.

object[]

Staged operations, each with id, action (VARIANT_ADD), details, ordering, and applied.

curl -X POST 'http://localhost:9000/vendor/products/prod_01HXYZ/variants' \
  -H 'Authorization: Bearer <token>' \
  -H 'x-seller-id: <seller_id>' \
  -H 'Content-Type: application/json' \
  -d '{"title": "L", "sku": "ACME-SHIRT-L", "options": {"Size": "L"}}'

const { product_change } = await client.vendor.products.$id.variants.mutate({
  $id: "prod_01HXYZ",
  title: "L",
  sku: "ACME-SHIRT-L",
  options: { Size: "L" },
})

{
  "product_change": {
    "id": "prodch_01HXYZ",
    "product_id": "prod_01HXYZ",
    "status": "pending",
    "actions": [
      {
        "id": "prodchact_01HXYZ",
        "action": "VARIANT_ADD",
        "details": { "title": "L", "sku": "ACME-SHIRT-L" },
        "applied": false
      }
    ]
  }
}

curl -X POST 'http://localhost:9000/vendor/products/prod_01HXYZ/variants' \
  -H 'Authorization: Bearer <token>' \
  -H 'x-seller-id: <seller_id>' \
  -H 'Content-Type: application/json' \
  -d '{"title": "L", "sku": "ACME-SHIRT-L", "options": {"Size": "L"}}'

const { product_change } = await client.vendor.products.$id.variants.mutate({
  $id: "prod_01HXYZ",
  title: "L",
  sku: "ACME-SHIRT-L",
  options: { Size: "L" },
})

{
  "product_change": {
    "id": "prodch_01HXYZ",
    "product_id": "prod_01HXYZ",
    "status": "pending",
    "actions": [
      {
        "id": "prodchact_01HXYZ",
        "action": "VARIANT_ADD",
        "details": { "title": "L", "sku": "ACME-SHIRT-L" },
        "applied": false
      }
    ]
  }
}

Overview

Panel extensions

Admin API

Vendor API

Store API

Configuration

Path parameters

Body parameters

Response

​Path parameters

​Body parameters

​Response

Path parameters

Body parameters

Response