Nyehandel

Create product

POST

/products

Request

Header Params

X-Identifier

string

optional

Example:

Authorization

string

optional

Example:

Bearer {{token}}

string

optional

Example:

application/json

Content-Type

string

optional

Example:

application/json

Body Params application/json

status

enum<string>

optional

Allowed values:

draftpublishedinactivepending_retirementretired

meta_title

string | null

optional

meta_description

string | null

optional

name

string

required

external_reference

string | null

optional

description

string | null

optional

short_description

string | null

optional

slug

string | null

optional

hs_code

string | null

optional

vat_rate

enum<integer>

optional

Allowed values:

250012006000

variants

array [object {14}]

required

sku

string

required

prices

object

optional

stock

integer | null

optional

weight

integer | null

optional

purchase_price

integer | null

optional

stock_price

integer | null

optional

package_size

integer | null

optional

supplier_sku

string | null

optional

gtin

string

optional

storage_space

string

optional

options

array [object {2}]

optional

Required if more than one variant

always_orderable

boolean

optional

positive_inventory_status

string

optional

negative_inventory_status

string

optional

type

enum<string>

required

Allowed values:

standardinventory_itempre_order_item

categories

array [object {3}] | null

optional

Set category or create if not found

name

string

required

external_identifier

string | null

optional

update_on_exists

boolean

optional

brand_name

string | null

optional

Set brand or create brand if not found

supplier_name

string | null

optional

Set supplier or create supplier if not found

filter_tags

array[string] | null

optional

images

array[string] | null

optional

Example

{
  "status": "draft",
  "name": "namn 2024-09-03",
  "meta_title": "Metis titilus",
  "meta_description": "Metus deskriptus",
  "external_reference": "Ext reffe",
  "description": "produktbeskrivningen",
  "hs_code": "12312321",
  "country_of_origin": "SE",
  "vat_rate": 1200,
  "variants": [
    {
      "sku": "20240901-hej57ad39",
      "stock": "291",
      "weight": "2500",
      "stock_price": 10000,
      "purchase_price": 1000,
      "supplier_sku": "Lev-art-100",
      "gtin": "Gtion-valle",
      "prices": [
        {
          "price": 15000,
          "tier": 1,
          "compare_price": 20000
        },
        {
          "price": 14000,
          "tier": 5,
          "compare_price": 20000
        },
        {
          "price": 14000,
          "tier": 10,
          "compare_price": 20000,
          "currency_id": 1
        }
      ],
      "options": [
        {
          "type": "Färg",
          "value": "Blå"
        },
        {
          "type": "Storlek",
          "value": "S"
        }
      ]
    }
  ],
  "categories": [
    {
      "name": "Jul",
      "update_on_exists": false
    },
    {
      "name": "kaosdkasd",
      "external_identifier": "api-1",
      "update_on_exists": false
    },
    {
      "name": "hejsan",
      "external_identifier": "api-1",
      "update_on_exists": false
    }
  ],
  "type": "inventory_item"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/products' \
--header 'X-Identifier: {{x_identifier}}' \
--header 'Authorization: Bearer {{token}}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "status": "draft",
    "name": "namn 2024-09-03",
    "meta_title": "Metis titilus",
    "meta_description": "Metus deskriptus",
    "external_reference": "Ext reffe",
    "description": "produktbeskrivningen",
    "hs_code": "12312321",
    "country_of_origin": "SE",
    "vat_rate": 1200,
    "variants": [
        {
            "sku": "20240901-hej57ad39",
            "stock": "291",
            "weight": "2500",
            "stock_price": 10000,
            "purchase_price": 1000,
            "supplier_sku": "Lev-art-100",
            "gtin": "Gtion-valle",
            "prices": [
                {
                    "price": 15000,
                    "tier": 1,
                    "compare_price": 20000
                },
                {
                    "price": 14000,
                    "tier": 5,
                    "compare_price": 20000
                },
                {
                    "price": 14000,
                    "tier": 10,
                    "compare_price": 20000,
                    "currency_id": 1
                }
            ],
            "options": [
                {
                    "type": "Färg",
                    "value": "Blå"
                },
                {
                    "type": "Storlek",
                    "value": "S"
                }
            ]
        }
    ],
    "categories": [
        {
            "name": "Jul",
            "update_on_exists": false
        },
        {
            "name": "kaosdkasd",
            "external_identifier": "api-1",
            "update_on_exists": false
        },
        {
            "name": "hejsan",
            "external_identifier": "api-1",
            "update_on_exists": false
        }
    ],
    "type": "inventory_item"
}'

Responses

🟢200Success

application/json

Body

object {0}

Example

{}

Modified at 2025-02-12 12:30:13

Create products batch

Update product