Skip to main content
PUT
/
v1
/
products
Update products
curl --request PUT \
  --url https://api.quickbutik.com/v1/products \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "product_id": 123,
    "variant_id": 123,
    "sku": "<string>",
    "is_giftcard": true,
    "title": "<string>",
    "price": 299,
    "before_price": 399,
    "purchase_price": 69,
    "tax_rate": 25,
    "stock": 1,
    "qty_location": "<string>",
    "disable_minusqty": "1",
    "visible": 1,
    "description": "<string>",
    "gtin": "<string>",
    "supplier_name": "<string>",
    "supplier_sku": "<string>",
    "datafield_1": "<string>",
    "datafield_2": "<string>",
    "datafield_3": "<string>",
    "seo_description": "<string>",
    "seo_title": "<string>",
    "weight": 400,
    "images": {},
    "preorder": 1,
    "metadata": {},
    "variants": {
      "sync": [
        {
          "variant_option1_name": "Color",
          "variant_option1_value": "Red",
          "variant_option2_name": "Size",
          "variant_option2_value": "Large",
          "variant_option3_name": "<string>",
          "variant_option3_value": "<string>",
          "variant_option4_name": "<string>",
          "variant_option4_value": "<string>",
          "variant_option5_name": "<string>",
          "variant_option5_value": "<string>",
          "sku": "<string>",
          "price": 123,
          "purchase_price": 123,
          "qty": 123,
          "qty_location": "<string>",
          "before_price": 123,
          "gtin": "<string>",
          "supplier_sku": "<string>",
          "weight": 123,
          "visible": 0,
          "preorder": 1,
          "images": [
            {}
          ]
        }
      ],
      "add": [
        {
          "variant_option1_name": "Color",
          "variant_option1_value": "Red",
          "variant_option2_name": "Size",
          "variant_option2_value": "Large",
          "variant_option3_name": "<string>",
          "variant_option3_value": "<string>",
          "variant_option4_name": "<string>",
          "variant_option4_value": "<string>",
          "variant_option5_name": "<string>",
          "variant_option5_value": "<string>",
          "sku": "<string>",
          "price": 123,
          "purchase_price": 123,
          "qty": 123,
          "qty_location": "<string>",
          "before_price": 123,
          "gtin": "<string>",
          "supplier_sku": "<string>",
          "weight": 123,
          "visible": 0,
          "preorder": 1,
          "images": [
            {}
          ]
        }
      ],
      "update": [
        {
          "variant_option1_name": "Color",
          "variant_option1_value": "Red",
          "variant_id": 123,
          "variant_option2_name": "Size",
          "variant_option2_value": "Large",
          "variant_option3_name": "<string>",
          "variant_option3_value": "<string>",
          "variant_option4_name": "<string>",
          "variant_option4_value": "<string>",
          "variant_option5_name": "<string>",
          "variant_option5_value": "<string>",
          "sku": "<string>",
          "price": 123,
          "purchase_price": 123,
          "qty": 123,
          "qty_location": "<string>",
          "before_price": 123,
          "gtin": "<string>",
          "supplier_sku": "<string>",
          "weight": 123,
          "visible": 0,
          "preorder": 1,
          "images": [
            {}
          ]
        }
      ]
    }
  }
]
'
{
  "success": 1,
  "errors": [
    "<string>"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://quickbutik.dev/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Basic Authentication with API Keys

The Quickbutik API uses Basic Authentication where you use your API key as both the username and password.

How it works:

  1. Format your credentials as api_key:api_key (using the SAME API key for both username and password)
  2. Base64 encode the formatted string
  3. Include in the Authorization header as: Authorization: Basic ENCODED_STRING

Example:

  • API Key: sk_live_abc123
  • Formatted: sk_live_abc123:sk_live_abc123
  • Base64 Encoded: c2tfbGl2ZV9hYmMxMjM6c2tfbGl2ZV9hYmMxMjM=
  • Header: Authorization: Basic c2tfbGl2ZV9hYmMxMjM6c2tfbGl2ZV9hYmMxMjM=

cURL Example:

curl https://api.quickbutik.com/v1/orders -u your_api_key:your_api_key

All API requests must be made over HTTPS. Requests made over HTTP will be rejected.

API keys can be generated in the Quickbutik Control Panel under Settings → API.

Body

application/json
​
product_id
integer

Product id - which you would like to update

​
variant_id
integer

Product variant id (if specific variant)

​
sku
string

(OR) Article Number - on product/variant which you would like to update

​
is_giftcard
boolean

Set or unset this product as a gift card. Requires the gift card app to be active for the shop.

Example:

true

​
title
string

Product title

​
price
integer

Price

Example:

299

​
before_price
integer

Compare price

Example:

399

​
purchase_price
integer

Purchase price (excl. vat)

Example:

69

​
tax_rate
integer

VAT percentage (%)

Example:

25

​
stock
integer

Stock quantity

Example:

1

​
qty_location
string

Stock location

​
disable_minusqty
string

Disable minus stock (dont allow the stock to go negative)

Example:

"1"

​
visible
integer
Example:

1

​
description
string

Product description

​
gtin
string

EAN number (GTIN)

​
supplier_name
string

Supplier name

​
supplier_sku
string

Supplier SKU/article number

​
datafield_1
string

Data field #1

​
datafield_2
string

Data field #2

​
datafield_3
string

Data field #3

​
seo_description
string

SEO description (if specific)

​
seo_title
string

SEO title (if specific)

​
weight
number

Weight (in grams)

Example:

400

​
images
object

Object with numeric string keys containing image objects. Each key represents an image position/index.

​
preorder
integer | null

Assign a preorder option to this product/variant by its ID. Set to null or 0 to clear the preorder status. Use GET /v1/settings/preorders to retrieve the list of valid preorder option IDs for your store.

Example:

1

​
metadata
object

Custom metadata for the product

​
variants
object

Product variants configuration

Response

Product updated

​
success
integer
Example:

1

​
errors
string[]