Bulk Update Products

Bulk update products

curl --request PUT \
  --url https://api.komerza.com/stores/{storeId}/products \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "productIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "shouldBlockVirtualPrivateNetworks": true,
  "blacklistedPaymentGateways": [
    "<string>"
  ],
  "isBestSeller": true,
  "description": "<string>",
  "deliveryMessage": "<string>",
  "customAffiliateDiscountPercentage": 50,
  "customFields": [
    {
      "label": "<string>",
      "identifier": "<string>",
      "type": "<string>",
      "isRequired": true,
      "placeholder": "<string>",
      "hint": "<string>"
    }
  ],
  "discordRoleId": "<string>",
  "randomizeKeyDelivery": true
}
'

import requests

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

payload = {
    "productIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "shouldBlockVirtualPrivateNetworks": True,
    "blacklistedPaymentGateways": ["<string>"],
    "isBestSeller": True,
    "description": "<string>",
    "deliveryMessage": "<string>",
    "customAffiliateDiscountPercentage": 50,
    "customFields": [
        {
            "label": "<string>",
            "identifier": "<string>",
            "type": "<string>",
            "isRequired": True,
            "placeholder": "<string>",
            "hint": "<string>"
        }
    ],
    "discordRoleId": "<string>",
    "randomizeKeyDelivery": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    productIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    shouldBlockVirtualPrivateNetworks: true,
    blacklistedPaymentGateways: ['<string>'],
    isBestSeller: true,
    description: '<string>',
    deliveryMessage: '<string>',
    customAffiliateDiscountPercentage: 50,
    customFields: [
      {
        label: '<string>',
        identifier: '<string>',
        type: '<string>',
        isRequired: true,
        placeholder: '<string>',
        hint: '<string>'
      }
    ],
    discordRoleId: '<string>',
    randomizeKeyDelivery: true
  })
};

fetch('https://api.komerza.com/stores/{storeId}/products', 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",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'productIds' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'shouldBlockVirtualPrivateNetworks' => true,
    'blacklistedPaymentGateways' => [
        '<string>'
    ],
    'isBestSeller' => true,
    'description' => '<string>',
    'deliveryMessage' => '<string>',
    'customAffiliateDiscountPercentage' => 50,
    'customFields' => [
        [
                'label' => '<string>',
                'identifier' => '<string>',
                'type' => '<string>',
                'isRequired' => true,
                'placeholder' => '<string>',
                'hint' => '<string>'
        ]
    ],
    'discordRoleId' => '<string>',
    'randomizeKeyDelivery' => true
  ]),
  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"

	payload := strings.NewReader("{\n  \"productIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"shouldBlockVirtualPrivateNetworks\": true,\n  \"blacklistedPaymentGateways\": [\n    \"<string>\"\n  ],\n  \"isBestSeller\": true,\n  \"description\": \"<string>\",\n  \"deliveryMessage\": \"<string>\",\n  \"customAffiliateDiscountPercentage\": 50,\n  \"customFields\": [\n    {\n      \"label\": \"<string>\",\n      \"identifier\": \"<string>\",\n      \"type\": \"<string>\",\n      \"isRequired\": true,\n      \"placeholder\": \"<string>\",\n      \"hint\": \"<string>\"\n    }\n  ],\n  \"discordRoleId\": \"<string>\",\n  \"randomizeKeyDelivery\": true\n}")

	req, _ := http.NewRequest("PUT", 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.put("https://api.komerza.com/stores/{storeId}/products")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"productIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"shouldBlockVirtualPrivateNetworks\": true,\n  \"blacklistedPaymentGateways\": [\n    \"<string>\"\n  ],\n  \"isBestSeller\": true,\n  \"description\": \"<string>\",\n  \"deliveryMessage\": \"<string>\",\n  \"customAffiliateDiscountPercentage\": 50,\n  \"customFields\": [\n    {\n      \"label\": \"<string>\",\n      \"identifier\": \"<string>\",\n      \"type\": \"<string>\",\n      \"isRequired\": true,\n      \"placeholder\": \"<string>\",\n      \"hint\": \"<string>\"\n    }\n  ],\n  \"discordRoleId\": \"<string>\",\n  \"randomizeKeyDelivery\": true\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"productIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"shouldBlockVirtualPrivateNetworks\": true,\n  \"blacklistedPaymentGateways\": [\n    \"<string>\"\n  ],\n  \"isBestSeller\": true,\n  \"description\": \"<string>\",\n  \"deliveryMessage\": \"<string>\",\n  \"customAffiliateDiscountPercentage\": 50,\n  \"customFields\": [\n    {\n      \"label\": \"<string>\",\n      \"identifier\": \"<string>\",\n      \"type\": \"<string>\",\n      \"isRequired\": true,\n      \"placeholder\": \"<string>\",\n      \"hint\": \"<string>\"\n    }\n  ],\n  \"discordRoleId\": \"<string>\",\n  \"randomizeKeyDelivery\": true\n}"

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

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

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

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

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

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

PUT

stores

{storeId}

products

Bulk update products

curl --request PUT \
  --url https://api.komerza.com/stores/{storeId}/products \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "productIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "shouldBlockVirtualPrivateNetworks": true,
  "blacklistedPaymentGateways": [
    "<string>"
  ],
  "isBestSeller": true,
  "description": "<string>",
  "deliveryMessage": "<string>",
  "customAffiliateDiscountPercentage": 50,
  "customFields": [
    {
      "label": "<string>",
      "identifier": "<string>",
      "type": "<string>",
      "isRequired": true,
      "placeholder": "<string>",
      "hint": "<string>"
    }
  ],
  "discordRoleId": "<string>",
  "randomizeKeyDelivery": true
}
'

import requests

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

payload = {
    "productIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "shouldBlockVirtualPrivateNetworks": True,
    "blacklistedPaymentGateways": ["<string>"],
    "isBestSeller": True,
    "description": "<string>",
    "deliveryMessage": "<string>",
    "customAffiliateDiscountPercentage": 50,
    "customFields": [
        {
            "label": "<string>",
            "identifier": "<string>",
            "type": "<string>",
            "isRequired": True,
            "placeholder": "<string>",
            "hint": "<string>"
        }
    ],
    "discordRoleId": "<string>",
    "randomizeKeyDelivery": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    productIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    shouldBlockVirtualPrivateNetworks: true,
    blacklistedPaymentGateways: ['<string>'],
    isBestSeller: true,
    description: '<string>',
    deliveryMessage: '<string>',
    customAffiliateDiscountPercentage: 50,
    customFields: [
      {
        label: '<string>',
        identifier: '<string>',
        type: '<string>',
        isRequired: true,
        placeholder: '<string>',
        hint: '<string>'
      }
    ],
    discordRoleId: '<string>',
    randomizeKeyDelivery: true
  })
};

fetch('https://api.komerza.com/stores/{storeId}/products', 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",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'productIds' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'shouldBlockVirtualPrivateNetworks' => true,
    'blacklistedPaymentGateways' => [
        '<string>'
    ],
    'isBestSeller' => true,
    'description' => '<string>',
    'deliveryMessage' => '<string>',
    'customAffiliateDiscountPercentage' => 50,
    'customFields' => [
        [
                'label' => '<string>',
                'identifier' => '<string>',
                'type' => '<string>',
                'isRequired' => true,
                'placeholder' => '<string>',
                'hint' => '<string>'
        ]
    ],
    'discordRoleId' => '<string>',
    'randomizeKeyDelivery' => true
  ]),
  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"

	payload := strings.NewReader("{\n  \"productIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"shouldBlockVirtualPrivateNetworks\": true,\n  \"blacklistedPaymentGateways\": [\n    \"<string>\"\n  ],\n  \"isBestSeller\": true,\n  \"description\": \"<string>\",\n  \"deliveryMessage\": \"<string>\",\n  \"customAffiliateDiscountPercentage\": 50,\n  \"customFields\": [\n    {\n      \"label\": \"<string>\",\n      \"identifier\": \"<string>\",\n      \"type\": \"<string>\",\n      \"isRequired\": true,\n      \"placeholder\": \"<string>\",\n      \"hint\": \"<string>\"\n    }\n  ],\n  \"discordRoleId\": \"<string>\",\n  \"randomizeKeyDelivery\": true\n}")

	req, _ := http.NewRequest("PUT", 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.put("https://api.komerza.com/stores/{storeId}/products")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"productIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"shouldBlockVirtualPrivateNetworks\": true,\n  \"blacklistedPaymentGateways\": [\n    \"<string>\"\n  ],\n  \"isBestSeller\": true,\n  \"description\": \"<string>\",\n  \"deliveryMessage\": \"<string>\",\n  \"customAffiliateDiscountPercentage\": 50,\n  \"customFields\": [\n    {\n      \"label\": \"<string>\",\n      \"identifier\": \"<string>\",\n      \"type\": \"<string>\",\n      \"isRequired\": true,\n      \"placeholder\": \"<string>\",\n      \"hint\": \"<string>\"\n    }\n  ],\n  \"discordRoleId\": \"<string>\",\n  \"randomizeKeyDelivery\": true\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"productIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"shouldBlockVirtualPrivateNetworks\": true,\n  \"blacklistedPaymentGateways\": [\n    \"<string>\"\n  ],\n  \"isBestSeller\": true,\n  \"description\": \"<string>\",\n  \"deliveryMessage\": \"<string>\",\n  \"customAffiliateDiscountPercentage\": 50,\n  \"customFields\": [\n    {\n      \"label\": \"<string>\",\n      \"identifier\": \"<string>\",\n      \"type\": \"<string>\",\n      \"isRequired\": true,\n      \"placeholder\": \"<string>\",\n      \"hint\": \"<string>\"\n    }\n  ],\n  \"discordRoleId\": \"<string>\",\n  \"randomizeKeyDelivery\": true\n}"

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

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

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

{
  "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 ID of the store.

Body

application/json

The Komerza.Common.Forms.Products.BulkUpdateProductForm with updates.

Form for updating multiple products in a store at once. All fields are nullable - only non-null values will be applied to the selected products.

productIds

string<uuid>[]

required

The list of product IDs to update

Minimum array length: 1

visibility

enum<integer>

List of product visibility (or privacy) levels

Available options:

0,

1,

2,

3

shouldBlockVirtualPrivateNetworks

boolean | null

Whether VPNs and proxies should be blocked from purchasing the products

blacklistedPaymentGateways

string[] | null

The array of blacklisted payment methods for the products

isBestSeller

boolean | null

Whether to mark the products as bestsellers

description

string | null

The description of the products (supports markdown)

Maximum string length: 50000

deliveryMessage

string | null

The message to include in the delivery email when the product is delivered. This will be applied to ALL variants of the selected products.

Maximum string length: 2048

affiliateDiscountMode

enum<integer>

Defines how affiliate discounts should be applied to a product.

Available options:

0,

1,

2

customAffiliateDiscountPercentage

integer<int32> | null

Custom affiliate discount percentage (0-100) when AffiliateDiscountMode is Custom

Required range: 0 <= x <= 100

customFields

object[] | null

Custom fields to apply to all variants of the selected products. When set, existing custom fields on each variant are removed and replaced with these.

Show child attributes

discordMode

enum<integer>

Determines when a customer is added to the Discord server and when they receive their role.

Available options:

0,

1

discordRequirement

enum<integer>

Determines whether Discord linking is required, optional, or disabled during checkout.

Available options:

0,

1,

2

discordRoleId

string | null

Discord role ID to assign to all variants of the selected products. When set, all variants will be mapped to this Discord role.

Maximum string length: 32

randomizeKeyDelivery

boolean | null

When set, updates whether license keys are selected randomly instead of FIFO for all variants.

Response

The object was successfully updated.

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

any | null

Represents the data associated with a response.

Last modified on August 29, 2025

Update Payment Settings

Order Products

API Documentation

Reference

OAuth2

User

Stores

Products

Categories

Variants

Coupons

Tickets

Customers

Orders

Reviews

Affiliates

Webhooks

Authorizations

Path Parameters

Body

Response