Create Physical Product

This API endpoint (POST) creates a physical product. If the request succeeds, it returns a Product Object﻿ otherwise, it will return an error. 

Permissions: products.create
Webhook event: product-created﻿ 
Body Parameters
tax_category string *
The tax category﻿ of the product.
﻿
pricing_model array of objects *
An array of objects, each representing a pricing model associated with the product. 
JSON
"pricing_model": [
    {
      "currency": "EUR",
      "price": 1200,
      "recommended_seller_price": 0,
      "acquisition_price": 0
    }
]
"pricing_model": [
    {
      "currency": "EUR",
      "price": 1200,
      "recommended_seller_price": 0,
      "acquisition_price": 0
    }
]
﻿
currency * string Currency Code﻿
The currency of the pricing model.
price * integer
The price of the item for this pricing model
recommended_seller_price integer
The recommended price set by the merchant for the product in this currency. 
acquisition_price integer
The base purchase price of the product in this currency.
﻿
languages object *
The titles, subtitles, seo descriptions, seo titles and long descriptions of the product in all supported languages. The minimum information required is a title in at least one language. The object's keys are a Language Codes﻿ while the values are also objects with the content of the product.
Note: A language has to be activated on your account before it can be used.
Exampe
"languages": {
    "en": {
        "title": "Blue T-Shirt",
        "description": "Exclusive Blue T-Shirt, just 100 pieces available",
        "seo_title": "Blue T-Shirt",
        "seo_description": "Exclusive Blue T-Shirt, just 100 pieces available",
        "slug": "blue-t-shirt"
    },
    "de": {
        // German content
    },
    "sv": {
        // Swedish content
    }
}
"languages": {
    "en": {
        "title": "Blue T-Shirt",
        "description": "Exclusive Blue T-Shirt, just 100 pieces available",
        "seo_title": "Blue T-Shirt",
        "seo_description": "Exclusive Blue T-Shirt, just 100 pieces available",
        "slug": "blue-t-shirt"
    },
    "de": {
        // German content
    },
    "sv": {
        // Swedish content
    }
}
﻿
﻿
stock_breakdown array of objects
An array of objects, each containing information about the warehouses and stock configuration of the product. You can ignore this parameter if configuring variations or the stock parameter.
Example
"stock_breakdown": [
    {
        "warehouse": "some-warehouse-id",
        "stock": 10
    },
    {
        "warehouse": "some-other-warehouse-id",
        "stock": 200
    }
]
"stock_breakdown": [
    {
        "warehouse": "some-warehouse-id",
        "stock": 10
    },
    {
        "warehouse": "some-other-warehouse-id",
        "stock": 200
    }
]
﻿
warehouse string
The id of the warehouse.
stock integer
The available stock for the product at this warehouse.
﻿
variations object
You can use variations if you have multiple types of the same product. Let's say you have a small and medium t-shirt but also blue or red; you can create a variation for each.
Example
Example with stock_breakdown (warehouses)
"variations" :{
    "delta_pricing": true,
    "options": [
        {
            "label": {
                "en": "Size",
                "de": "Größe"
            },
            "values": [
                {
                    "en": "Large",
                    "de": "Klein"
                }
            ],
            "type": "dropdown-list"
        }
    ],
    "variants": [
        {
            "options": [
               {
                   "Size": "Large",
                   "Sizen": "Klein"
               }
            ],
            "stock": 100,
            "unlimited_stock": false,
            "allow_negative_stock": false,
            "hide_if_no_stock": true,
            "shown": true,
            "dimensions": {
                "height": 1,
                "length": 1,
                "width": 1
            },
            "gallery": [],
            "sku": "SKUNUMBER",
            "pricing_model": [
                {
                    "currency": "EUR",
                    "price": 100
                }
            ]
        }
    ]
}

"variations" :{
    "delta_pricing": true,
    "options": [
        {
            "label": {
                "en": "Size",
                "de": "Größe"
            },
            "values": [
                {
                    "en": "Large",
                    "de": "Klein"
                }
            ],
            "type": "dropdown-list"
        }
    ],
    "variants": [
        {
            "options": [
               {
                   "Size": "Large",
                   "Sizen": "Klein"
               }
            ],
            "stock": 100,
            "unlimited_stock": false,
            "allow_negative_stock": false,
            "hide_if_no_stock": true,
            "shown": true,
            "dimensions": {
                "height": 1,
                "length": 1,
                "width": 1
            },
            "gallery": [],
            "sku": "SKUNUMBER",
            "pricing_model": [
                {
                    "currency": "EUR",
                    "price": 100
                }
            ]
        }
    ]
}
﻿
delta_pricing boolean
Determines how the cost is calculated for all the variants. If delta_pricing is set to true, the cost is added (or deducted) from the base product price. If it is set to false, then the cost is fixed and taken directly from the variant pricing models.
options array of objects 
An array of objects, each corresponding to an option such as size or color.
label object
The label of the option in all supported languages. It is an object with key-value pairs representing a supported language and its corresponding label.
values array of objects
The values of the option such as small, red and large in all supported languages. It is an object with key-value pairs representing a supported language and its corresponding label.
type string
The option type determines how they are displayed to customers during checkout in Tamio Sites. The possible values are dropdown-listand radio-buttons.
﻿
variations array of objects
An array of objects, each representive an actual product variant.
gallery array of strings
Each string in the array is an asset id.
shown boolean
Determines whether the variant is currently visible in external assets.
allow_negative_stock boolean
This attribute shows whether you can accept orders for this variant if it runs out of stock.  Available for physical products.
hide_if_no_stock boolean
This attribute shows if the variant is visible in external assets such as sites and checkout flows if it runs out of stock. Available for physical products.
sku string
The variant's SKU number. Available for physical products.
ean string
The variant's EAN number. Available for physical products.
weight number
The weight of the variant. Available for physical products.
stock integer
The total available stock of the variant.
pricing_model array of objects
An array of objects, each representing a pricing model configured on the variant.
stock_breakdown array of objects
An array of objects each containing information about the warehouses and stock configuration of the product. Available for physical products
warehouse string
The id of the warehouse.
stock integer
The available stock for the product at this warehouse.
dimensions object
An object with the dimensions of the variant. Available for physical products.
length number
The length of the variant.
height number
The height of the variant.
width number
The width of the variant.
options object
The keys of the object correspond to a supported language. The values are also objects with the option configuration in that language. 
﻿
packs array of objects
If you sell in bulk, you can group your product into packs. This means customers will purchase one pack at a time instead of the default standard units during checkout. To add packs to your product, you need to configure the packs array with the following attributes:
Example
Example with Variations
"packs": [
  {
    "label": "Pack of 10",
    "stock": 10,
    "multiple": false
  },
  {
    "label": "Pack of 5",
    "stock": 5,
    "multiple": false
  }
]
"packs": [
  {
    "label": "Pack of 10",
    "stock": 10,
    "multiple": false
  },
  {
    "label": "Pack of 5",
    "stock": 5,
    "multiple": false
  }
]
﻿
label string *
The label of your pack.
stock integer *
The total stock contained in this pack.
multiples boolean
Determines if customers can purchase multiple packs in the same order. The default value is false.
variants array of objects
An array of objects with the variant configuration of the pack. Required if your product has variations. Each object requires the id of the variant and the stock available.
Note: When creating packs with variants, you must pass the variant's id in the request. This means that you have to create the product with its variants first and then configure its packages. 
﻿
stock integer *
The available stock for this product. You can ignore this parameter if adding variations to the item or warehouses.
﻿
stock_limit_warning integer
If the product stock falls below this value, an email notification will be sent to you.
﻿
max_units integer
The maximum amount of stock that can be purchased in a single order.
﻿
min_units integer
The minimum amount of stock that can be purchased in a single order.
﻿
buyable boolean
This attribute shows if the product is available for sale.
﻿
on_sale boolean
This attribute shows if there is a specific sale or promotion active currently active.
﻿
discount_allowed boolean
Determines if the product can have any discounts applied to it. The default value is true.
﻿
reviews_allowed boolean
This attribute shows if customers can leave reviews for this item. The default value is false.
﻿
shown boolean
Determines if the product is currently visible in external assets. The default value is true.
﻿
exclude_from_feed boolean
Determines if the product will be included in third-party feeds and product search engines.
﻿
allow_negative_stock boolean
This attribute shows whether you can accept orders for this product if it runs out of stock.
﻿
hide_if_no_stock boolean
This attribute shows if the product can be shown in external assets such as sites and checkout flows if it runs out of stock.
﻿
new_from date-format﻿
The date that the product was launched for sale as a brand new item.
﻿
new_to date-format﻿
After this date, the product will not be considered a new item. 
﻿
expiry_date date-format﻿
After this date, the product will not be available for sale.
﻿
release_date date-format﻿
The date that the product will be released for sale.
﻿
gallery array of strings
Each string in the array must be an Asset id.
﻿
sku string
The product's SKU number.
﻿
mpn string
The product's MPN number.
﻿
asin string
The product's ASIN number.
﻿
ean string
The product's EAN number.
﻿
brand string
The product's brand.
﻿
model string
The model of the product.
﻿
isbn string
The product's ISBN number. 
﻿
hscode string
The product's HS code. 
﻿
upc string
The product's UPC number.
﻿
gtin string
The product's GTIN number.
﻿
sample boolean
This attribute shows if the available stock is sold as a sample.
﻿
related_products array of strings
An array of product IDs, each representing a related product.
﻿
whitelist array of strings
An array of ISO country codes. Only customers from these countries can purchase this product. 
﻿
custom_attributes array of objects
An array of objects each corresponding to a custom attribute configured on the product. 
JSON
"custom_attributes": [
  {
    "language": "en",
    "name": "Attribute name",
    "value": "Attribute value"
  }
]
"custom_attributes": [
  {
    "language": "en",
    "name": "Attribute name",
    "value": "Attribute value"
  }
]
﻿
language string
The language of the custom attribute.
name string
This name of the custom attribute.
value string
The value of the custom attribute.
﻿
custom_fields array of objects
An array of objects each corresponding to a custom field configured on the product. 
JSON
"custom_fields": [
  {
    "language": "en",
    "name": "Field name",
    "type": "checkboxes",
    "values": [
        "value1",
        "value2"
    ]
  },
  {
    "language": "en",
    "name": "Name",
    "range_from": 1709762400,
    "range_to": 1711749600,
    "type": "date-picker"
  }
]
"custom_fields": [
  {
    "language": "en",
    "name": "Field name",
    "type": "checkboxes",
    "values": [
        "value1",
        "value2"
    ]
  },
  {
    "language": "en",
    "name": "Name",
    "range_from": 1709762400,
    "range_to": 1711749600,
    "type": "date-picker"
  }
]
﻿
language string
The language of the custom field.
name string
This name of the custom field.
type string
This type of the custom field. The possible values are size, checkboxes, textfield, textarea, date-picker.
values array of strings
An array of strings, each represtive a value for the custom field. Available for custom fields with type "checkboxes".
range_from timestamp
The starting range for the custom fields. Available for custom fields with type "range_from".
range_to string
The starting range for the custom fields. Available for custom fields with type "range_to".
﻿
﻿
/
/v2/products/create/physical
View
﻿
﻿
Product Object
Create Service