Create Service

This API endpoint (POST) creates a service 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
    }
}
﻿
﻿
unlimited_stock boolean
The default value is false. You can set this to true if the tax_category of the product is Digital Services.
﻿
stock integer
The available stock for this product. You can ignore this parameter if unlimited_stock is set to true.
﻿
stock_limit_warning integer
If the product stock falls below this value, an email notification will be sent to you. Not supported for services with unlimited_stock is set to true.
﻿
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.
﻿
new_from date-format﻿
The date 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.
﻿
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".
﻿
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
"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,
            "shown": true,
            "gallery": [],
            "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,
            "shown": true,
            "gallery": [],
            "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.
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.
options object
The keys of the object correspond to a supported language. The values are also objects with the option configuration in that language. 
﻿
/
/v2/products/create/service
View
﻿
﻿
Create Physical Product
Create Digital Product