Create Variant

Create variant

curl --request POST \
  --url https://api.komerza.com/stores/{storeId}/products/{productId}/variants \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "cost": 50000,
  "minimumQuantity": 1073741824,
  "maximumQuantity": 1073741823,
  "order": 1073741824,
  "stock": 1073741823,
  "deliveryTypes": [
    "<string>"
  ],
  "disableVolumeDiscountOnCoupon": true,
  "randomizeKeyDelivery": true,
  "description": "<string>",
  "dynamicUrl": "<string>",
  "deliveryMessage": "<string>",
  "customIntervalDays": 123
}
'

import requests

url = "https://api.komerza.com/stores/{storeId}/products/{productId}/variants"

payload = {
    "name": "<string>",
    "cost": 50000,
    "minimumQuantity": 1073741824,
    "maximumQuantity": 1073741823,
    "order": 1073741824,
    "stock": 1073741823,
    "deliveryTypes": ["<string>"],
    "disableVolumeDiscountOnCoupon": True,
    "randomizeKeyDelivery": True,
    "description": "<string>",
    "dynamicUrl": "<string>",
    "deliveryMessage": "<string>",
    "customIntervalDays": 123
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    cost: 50000,
    minimumQuantity: 1073741824,
    maximumQuantity: 1073741823,
    order: 1073741824,
    stock: 1073741823,
    deliveryTypes: ['<string>'],
    disableVolumeDiscountOnCoupon: true,
    randomizeKeyDelivery: true,
    description: '<string>',
    dynamicUrl: '<string>',
    deliveryMessage: '<string>',
    customIntervalDays: 123
  })
};

fetch('https://api.komerza.com/stores/{storeId}/products/{productId}/variants', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.komerza.com/stores/{storeId}/products/{productId}/variants",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'cost' => 50000,
    'minimumQuantity' => 1073741824,
    'maximumQuantity' => 1073741823,
    'order' => 1073741824,
    'stock' => 1073741823,
    'deliveryTypes' => [
        '<string>'
    ],
    'disableVolumeDiscountOnCoupon' => true,
    'randomizeKeyDelivery' => true,
    'description' => '<string>',
    'dynamicUrl' => '<string>',
    'deliveryMessage' => '<string>',
    'customIntervalDays' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.komerza.com/stores/{storeId}/products/{productId}/variants"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"cost\": 50000,\n  \"minimumQuantity\": 1073741824,\n  \"maximumQuantity\": 1073741823,\n  \"order\": 1073741824,\n  \"stock\": 1073741823,\n  \"deliveryTypes\": [\n    \"<string>\"\n  ],\n  \"disableVolumeDiscountOnCoupon\": true,\n  \"randomizeKeyDelivery\": true,\n  \"description\": \"<string>\",\n  \"dynamicUrl\": \"<string>\",\n  \"deliveryMessage\": \"<string>\",\n  \"customIntervalDays\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.komerza.com/stores/{storeId}/products/{productId}/variants")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"cost\": 50000,\n  \"minimumQuantity\": 1073741824,\n  \"maximumQuantity\": 1073741823,\n  \"order\": 1073741824,\n  \"stock\": 1073741823,\n  \"deliveryTypes\": [\n    \"<string>\"\n  ],\n  \"disableVolumeDiscountOnCoupon\": true,\n  \"randomizeKeyDelivery\": true,\n  \"description\": \"<string>\",\n  \"dynamicUrl\": \"<string>\",\n  \"deliveryMessage\": \"<string>\",\n  \"customIntervalDays\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.komerza.com/stores/{storeId}/products/{productId}/variants")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"cost\": 50000,\n  \"minimumQuantity\": 1073741824,\n  \"maximumQuantity\": 1073741823,\n  \"order\": 1073741824,\n  \"stock\": 1073741823,\n  \"deliveryTypes\": [\n    \"<string>\"\n  ],\n  \"disableVolumeDiscountOnCoupon\": true,\n  \"randomizeKeyDelivery\": true,\n  \"description\": \"<string>\",\n  \"dynamicUrl\": \"<string>\",\n  \"deliveryMessage\": \"<string>\",\n  \"customIntervalDays\": 123\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "<string>",
  "code": "<string>",
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "dateCreated": "2023-11-07T05:31:56Z",
    "name": "<string>",
    "productId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "storeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "cost": 50000,
    "deliveryTypes": [
      "<string>"
    ],
    "files": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "dateCreated": "2023-11-07T05:31:56Z",
        "friendlyName": "<string>",
        "ipAddress": "<string>",
        "userId": "<string>"
      }
    ],
    "minimumQuantity": 123,
    "maximumQuantity": 123,
    "order": 123,
    "imageNames": [
      "<string>"
    ],
    "stock": 123,
    "customFields": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "dateCreated": "2023-11-07T05:31:56Z",
        "variantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "label": "<string>",
        "identifier": "<string>",
        "type": "<string>",
        "isRequired": true,
        "options": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "dateCreated": "2023-11-07T05:31:56Z",
            "customFieldId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "label": "<string>",
            "value": "<string>",
            "order": 1073741823
          }
        ],
        "placeholder": "<string>",
        "hint": "<string>"
      }
    ],
    "volumeDiscounts": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "dateCreated": "2023-11-07T05:31:56Z",
        "variantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "quantity": 1073741824,
        "discountValue": 50000
      }
    ],
    "disableVolumeDiscountOnCoupon": true,
    "randomizeKeyDelivery": true,
    "description": "<string>",
    "dynamicUrl": "<string>",
    "deliveryMessage": "<string>",
    "metadata": "<string>",
    "customIntervalDays": 123
  }
}

{
  "success": true,
  "message": "<string>",
  "code": "<string>",
  "data": "<unknown>"
}

{
  "success": true,
  "message": "<string>",
  "code": "<string>",
  "data": "<unknown>"
}

{
  "success": true,
  "message": "<string>",
  "code": "<string>",
  "data": "<unknown>"
}

POST

stores

{storeId}

products

{productId}

variants

Create variant

curl --request POST \
  --url https://api.komerza.com/stores/{storeId}/products/{productId}/variants \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "cost": 50000,
  "minimumQuantity": 1073741824,
  "maximumQuantity": 1073741823,
  "order": 1073741824,
  "stock": 1073741823,
  "deliveryTypes": [
    "<string>"
  ],
  "disableVolumeDiscountOnCoupon": true,
  "randomizeKeyDelivery": true,
  "description": "<string>",
  "dynamicUrl": "<string>",
  "deliveryMessage": "<string>",
  "customIntervalDays": 123
}
'

import requests

url = "https://api.komerza.com/stores/{storeId}/products/{productId}/variants"

payload = {
    "name": "<string>",
    "cost": 50000,
    "minimumQuantity": 1073741824,
    "maximumQuantity": 1073741823,
    "order": 1073741824,
    "stock": 1073741823,
    "deliveryTypes": ["<string>"],
    "disableVolumeDiscountOnCoupon": True,
    "randomizeKeyDelivery": True,
    "description": "<string>",
    "dynamicUrl": "<string>",
    "deliveryMessage": "<string>",
    "customIntervalDays": 123
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    cost: 50000,
    minimumQuantity: 1073741824,
    maximumQuantity: 1073741823,
    order: 1073741824,
    stock: 1073741823,
    deliveryTypes: ['<string>'],
    disableVolumeDiscountOnCoupon: true,
    randomizeKeyDelivery: true,
    description: '<string>',
    dynamicUrl: '<string>',
    deliveryMessage: '<string>',
    customIntervalDays: 123
  })
};

fetch('https://api.komerza.com/stores/{storeId}/products/{productId}/variants', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.komerza.com/stores/{storeId}/products/{productId}/variants",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'cost' => 50000,
    'minimumQuantity' => 1073741824,
    'maximumQuantity' => 1073741823,
    'order' => 1073741824,
    'stock' => 1073741823,
    'deliveryTypes' => [
        '<string>'
    ],
    'disableVolumeDiscountOnCoupon' => true,
    'randomizeKeyDelivery' => true,
    'description' => '<string>',
    'dynamicUrl' => '<string>',
    'deliveryMessage' => '<string>',
    'customIntervalDays' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.komerza.com/stores/{storeId}/products/{productId}/variants"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"cost\": 50000,\n  \"minimumQuantity\": 1073741824,\n  \"maximumQuantity\": 1073741823,\n  \"order\": 1073741824,\n  \"stock\": 1073741823,\n  \"deliveryTypes\": [\n    \"<string>\"\n  ],\n  \"disableVolumeDiscountOnCoupon\": true,\n  \"randomizeKeyDelivery\": true,\n  \"description\": \"<string>\",\n  \"dynamicUrl\": \"<string>\",\n  \"deliveryMessage\": \"<string>\",\n  \"customIntervalDays\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.komerza.com/stores/{storeId}/products/{productId}/variants")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"cost\": 50000,\n  \"minimumQuantity\": 1073741824,\n  \"maximumQuantity\": 1073741823,\n  \"order\": 1073741824,\n  \"stock\": 1073741823,\n  \"deliveryTypes\": [\n    \"<string>\"\n  ],\n  \"disableVolumeDiscountOnCoupon\": true,\n  \"randomizeKeyDelivery\": true,\n  \"description\": \"<string>\",\n  \"dynamicUrl\": \"<string>\",\n  \"deliveryMessage\": \"<string>\",\n  \"customIntervalDays\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.komerza.com/stores/{storeId}/products/{productId}/variants")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"cost\": 50000,\n  \"minimumQuantity\": 1073741824,\n  \"maximumQuantity\": 1073741823,\n  \"order\": 1073741824,\n  \"stock\": 1073741823,\n  \"deliveryTypes\": [\n    \"<string>\"\n  ],\n  \"disableVolumeDiscountOnCoupon\": true,\n  \"randomizeKeyDelivery\": true,\n  \"description\": \"<string>\",\n  \"dynamicUrl\": \"<string>\",\n  \"deliveryMessage\": \"<string>\",\n  \"customIntervalDays\": 123\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "<string>",
  "code": "<string>",
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "dateCreated": "2023-11-07T05:31:56Z",
    "name": "<string>",
    "productId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "storeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "cost": 50000,
    "deliveryTypes": [
      "<string>"
    ],
    "files": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "dateCreated": "2023-11-07T05:31:56Z",
        "friendlyName": "<string>",
        "ipAddress": "<string>",
        "userId": "<string>"
      }
    ],
    "minimumQuantity": 123,
    "maximumQuantity": 123,
    "order": 123,
    "imageNames": [
      "<string>"
    ],
    "stock": 123,
    "customFields": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "dateCreated": "2023-11-07T05:31:56Z",
        "variantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "label": "<string>",
        "identifier": "<string>",
        "type": "<string>",
        "isRequired": true,
        "options": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "dateCreated": "2023-11-07T05:31:56Z",
            "customFieldId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "label": "<string>",
            "value": "<string>",
            "order": 1073741823
          }
        ],
        "placeholder": "<string>",
        "hint": "<string>"
      }
    ],
    "volumeDiscounts": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "dateCreated": "2023-11-07T05:31:56Z",
        "variantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "quantity": 1073741824,
        "discountValue": 50000
      }
    ],
    "disableVolumeDiscountOnCoupon": true,
    "randomizeKeyDelivery": true,
    "description": "<string>",
    "dynamicUrl": "<string>",
    "deliveryMessage": "<string>",
    "metadata": "<string>",
    "customIntervalDays": 123
  }
}

{
  "success": true,
  "message": "<string>",
  "code": "<string>",
  "data": "<unknown>"
}

{
  "success": true,
  "message": "<string>",
  "code": "<string>",
  "data": "<unknown>"
}

{
  "success": true,
  "message": "<string>",
  "code": "<string>",
  "data": "<unknown>"
}

Authorizations

Authorization

string

header

required

Your API key goes here

Path Parameters

storeId

string<uuid>

required

The store’s unique identifier.

productId

string<uuid>

required

The product’s unique identifier.

Body

The form containing the variant’s initial data.

The form used to create a product variant.

name

string

required

The display name of the variant.

Required string length: 3 - 128

cost

number<double>

required

The cost of the variant (non-negative).

Required range: 0 <= x <= 100000

minimumQuantity

integer<int32>

required

Minimum quantity allowed per order (at least 1).

Required range: 1 <= x <= 2147483647

maximumQuantity

integer<int32>

required

Maximum quantity allowed per order. Set to -1 for unlimited.

Required range: -1 <= x <= 2147483647

order

integer<int32>

required

Sort order for display (at least 1).

Required range: 1 <= x <= 2147483647

type

enum<integer>

required

The type of product that is being sold

Available options:

0,

1

stock

integer<int32>

required

Stock quantity available (non-negative).

Required range: 0 <= x <= 2147483647

deliveryTypes

string[]

required

Enabled delivery types. Valid values: license_keys, dynamic, keyauth, instructions, files.

stockMode

enum<integer>

required

The stock calculation modes that are used

Available options:

0,

1,

2

disableVolumeDiscountOnCoupon

boolean

required

When true, volume discounts are disabled if a coupon is applied to the order.

randomizeKeyDelivery

boolean

required

When true, license keys are selected randomly from inventory instead of FIFO order.

description

string | null

Optional description shown to customers for this variant.

Maximum string length: 4096

dynamicUrl

string<uri> | null

URL for dynamic fulfillment (when using the "dynamic" delivery type).

Maximum string length: 2048

deliveryMessage

string | null

Optional message shown on delivery.

Maximum string length: 4096

billingInterval

enum<integer>

The billing interval for a subscription product

Available options:

0,

1,

2,

3,

4

customIntervalDays

integer<int32> | null

Custom interval in days when BillingInterval is set to Custom.

Response

The object was successfully created.

Represents a default generic response for API endpoints.

success

boolean

required

Indicates whether the operation or response was successful.

message

string | null

A descriptive message providing additional context or information about the response.

code

string | null

The error code (if there was an error) to use when referencing the error

data

object

Represents a configurable variant associated with a product, containing various properties such as pricing, stock, delivery options, and custom fields.

Show child attributes

Last modified on August 29, 2025

API Documentation

Reference

OAuth2

User

Stores

Products

Categories

Variants

Coupons

Tickets

Customers

Orders

Reviews

Affiliates

Webhooks

Authorizations

Path Parameters

Body

Response