---
title: "Create product option"
method: POST
path: "/api/sites/multiscreen/{site_name}/ecommerce/options"
tags: ["Product options API"]
---

# Create product option

`POST /api/sites/multiscreen/{site_name}/ecommerce/options`

## Request

- Base URL: `https://api.duda.co`
- URL: `https://api.duda.co/api/sites/multiscreen/{site_name}/ecommerce/options`
- Auth: HTTP basic

Creates new product option for given catalog

## Path parameters

- `site_name` string, required

## Request body

- CreateProductOption: Request used to create product option
  - `choices` OptionChoiceRequest[]: Values available for given option. Can be strings (backward compatible) or objects with value and optional color.
    - `color` string, nullable: CSS color value for color option choices (hex codes, rgb/rgba, hsl/hsla, or named colors like 'tomato'). Only used when the parent ProductOption type is COLOR.
    - `id` string, nullable: Choice identifier for updating existing choices. Omit for new choices.
    - `value` string, required: Displayed choice name
  - `name` string, required: Displayed option name
  - `type` 'TEXT' | 'COLOR', nullable: Product option type

## Response `200`

OK

- ProductOption: Model representing options that can be assigned to products to define variations
  - `choices` ProductOptionChoice[]: Allowed choices to select from
    - `color` string
    - `id` string: Immutable identifier for referencing
    - `value` string: Option choice value
  - `id` string: Immutable identifier for referencing
  - `name` string: Displayed option name
  - `type` 'TEXT' | 'COLOR', nullable: Product option type

## Other responses

- `400`: Non-OK response from the server
- `401`: Unauthorized request - missing or invalid credentials
- `429`: Rate limit exceeded - please refer to api documentation for limits

---

[API](https://skmtc.dev/duda/apis/duda-partner-api.md) - [All operations](https://skmtc.dev/duda/apis/duda-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duda/apis/duda-partner-api/revisions/52be4d41cb12?raw)