Create Variation Option

Add a new variation option to a store product. Variation options define properties like "Size" or "Color" and their possible values.

Endpoint

POST /v1/store-products/{id}/variation-options

Authentication

Requires an API key with the store:write scope.

Parameters

Parameter	Type	Location	Description
id	integer	path	The store product ID

Request Body

Field	Type	Required	Description
name	string	Yes	Option name (max 255 characters), e.g., "Size", "Color"
values	array	No	List of possible string values for this option (e.g., ["Small", "Medium", "Large"])

tip

You can create the option without values first and add values later using the Update Variation Option endpoint.

Response

Success (201 Created)

{
  "data": {
    "id": 1,
    "name": "Size",
    "values": ["Small", "Medium", "Large"]
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-02-15T12:00:00+00:00"
  }
}

Errors

Status	Code	Description
401	authentication_required	No API key provided
401	invalid_api_key	Invalid API key
403	insufficient_scope	API key lacks store:write scope
404	resource_not_found	Store product does not exist
422	validation_error	Invalid request body
422	variations_not_enabled	Product does not have variations enabled

note

You must enable variations on the product before creating variation options. Update the product with variations: true using the Update Store Product endpoint.

Example Request

curl -X POST "https://app.equipdash.com/api/v1/store-products/1/variation-options" \
  -H "Authorization: Bearer eqd_live_abc123xyz789..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Size",
    "values": ["Small", "Medium", "Large"]
  }'