post

/catalog/products/{product_id}/modifiers/{modifier_id}/values

Creates a Modifier Value.

Required Fields

  • label
  • sort_order

Read-Only Fields

  • id

Authorization

apiKey - X-Auth-Client
apiKey - X-Auth-Token

Request Parameters

2 Path Parameters
2 Headers

Request Body

1 Example
Schema
object

The model for a POST to create a modifier value on a product.

is_default
boolean

The flag for preselecting a value as the default on the storefront. This field is not supported for swatch options/modifiers.

1 validation
label
string

The text display identifying the value on the storefront. Required in a /POST.

2 validations + required
sort_order
integer

The order in which the value will be displayed on the product page. Required in a /POST.

4 validations + required
value_data
object

Extra data describing the value, based on the type of option or modifier with which the value is associated. The swatch type option can accept an array of colors, with up to three hexidecimal color keys; or an image_url, which is a full image URL path including protocol. The product list type option requires a product_id. The checkbox type option requires a boolean flag, called checked_value, to determine which value is considered to be the checked state.

adjusters
object

Responses

1 Example
Schema
object
data
object

Part of Modifier Value Response

meta
object

Empty meta object; may be used later.

Send a Test Request

Send requests directly from the browser (CORS must be enabled)
Path Params
2 path params not set
product_id
modifier_id
$$.env
2 variables not set
store_hash
X-Auth-Client
X-Auth-Token