Create a new variant value

POST /v1/sku-variants/values

Create a new variant value

Add a value to a variant option, for example Red to Color. Values are listed in the order they are created (order starts at 0); use POST /v1/sku-variants/values/reorder to change it. A value name must be unique within its option (400 otherwise).

skuSuffixes connect variant SKU codes to values. When an order arrives with a code that is not an exact SKU code, Printago looks for a SKU whose code is a prefix of it and reads the rest as one suffix per bound option, in binding order. Personalization options and optional bindings are not part of the code. With BENCHY bound to Color and Red carrying the suffix -RED, the code BENCHY-RED resolves to BENCHY with Color = Red. A value can have several suffixes.

Requires: sku.edit

Request Body

- Variant value data

CreateSkuOptionValueRequest

aliasesoptional

string[]

Alternate names that resolve to this value in name-based lookups.

namerequired

string

optionIdrequired

string

ID of the option this value belongs to, from POST /v1/sku-variants or GET /v1/sku-variants.

pattern: ^[a-z0-9]{24}$

skuSuffixesoptional

string[]

Suffixes that identify this value at the end of a variant SKU code, including any separator (for example -RED).

Example Request

application/json

{
  "name": "string",
  "optionId": "string",
  "skuSuffixes": [
    "string"
  ],
  "aliases": [
    "string"
  ]
}

Examples

Add a color with a SKU suffix

Request

{
  "optionId": "v2a6r0i4a8n1t5c9o3l7o2r6",
  "name": "Red",
  "skuSuffixes": [
    "-RED"
  ]
}

Response

{
  "id": "r3e7d1v5a9l2u6e0q4w8e3r7",
  "storeId": "k3m9x2p7q8r4t6v1w5y0z3a2",
  "optionId": "v2a6r0i4a8n1t5c9o3l7o2r6",
  "name": "Red",
  "skuSuffixes": [
    "-RED"
  ],
  "order": 0,
  "createdAt": "2026-09-23T16:24:10.559Z",
  "updatedAt": "2026-09-23T16:24:10.559Z"
}

Response Schema

SkuOptionValue

aliasesoptionalnullable

string[]

Alternate names (as the merchant typed them) that resolve to this value.

createdAtrequired

string

format: date-time

idrequired

string

pattern: ^[a-z0-9]{24}$

namerequired

string

optionIdrequirednullable

string

ID of the option this value belongs to, from POST /v1/sku-variants or GET /v1/sku-variants.

pattern: ^[a-z0-9]{24}$

orderrequired

number

skuSuffixesoptionalnullable

string[]

Suffixes that identify this value at the end of a variant SKU code, including any separator (for example -RED).

storeIdrequired

string

pattern: ^[a-z0-9]{24}$

updatedAtrequired

string

format: date-time

Example Response

201 OK — application/json

{
  "name": "string",
  "optionId": "string",
  "skuSuffixes": [
    "string"
  ],
  "aliases": [
    "string"
  ],
  "order": 1,
  "id": "string",
  "storeId": "string",
  "createdAt": "2025-01-15T12:00:00.000Z",
  "updatedAt": "2025-01-15T12:00:00.000Z"
}