Documentation API Tunetoo

About the Tunetoo API

1. About the Tunetoo API
2. How to start
3. Authentication
4. Authentication examples
5. Requests
6. Responses

Tunetoo API

1. Orders
2. Webhooks
3. Products
- Get all Product list

About the Tunetoo API

The Tunetoo API uses a HTTP protocol. HTTP GET, POST and DELETE methods are used to access the API, allowing CRUD operations from a JSON input.

How to start

Create a Tunetoo account or sign into an existing account.
Create an API Tunetoo store in order to get your API key and secret.

Authentication

You will need to authenticate your store for all API requests. Tunetoo uses HTTP basic authentication for the API requests. Your store API key needs to be added as a header (X-TUNETOO-API-KEY) for every request.

Tunetoo API uses HMAC (hash based message authentication). A hashed version of your API store's secret, called the signature, will also need to be present as an HTTP header named X-TUNETOO-SIGNATURE. The signature is composed of a hash of the request (from your POST data) using your API secret and SHA256.

Authentication examples

          
            Signature generation example in PHP for a POST request
                          
                $api_key = "31938dd85ab5a2bfce57e9eexample";
                $secret = "bc69152203689725a73fc45example";
  
                $data = [
                  'test' =>
                  [
                    'id' => 1,
                    'data' =>
                    [
                        'name' => 'example1',
                        'value' => 'example value 1',
                    ],
                    [
                      'name' => 'example2',
                      'value' => 'example value 2',
                    ]
                  ]
                ];
  
                $json_data = json_encode($data);
  
                $signature = base64_encode(hash_hmac('sha256', $json_data, $secret, true));
              
            
          
        

Please note that the message for any GET or DELETE request is considered to be an empty array.

          
            Signature generation example in PHP for a GET request
                          
                $api_key = "31938dd85ab5a2bfce57e9eexample";
                $secret = "bc69152203689725a73fc45example";
  
                $data = [];
  
                $json_data = json_encode($data);
  
                $signature = base64_encode(hash_hmac('sha256', $json_data, $secret, true));

If you try to read or modify a resource without a valid authentication signature, a 401 response message will be sent in response:

          
            401 example response
                          
                {
                    "code": "error",
                    "message": "Unauthorized",
                    "data": {
                        "status": 401
                    }
                }

Requests

Request and response formats

The response body is always a JSON object. For POST requests, the data can be passed as a JSON encoded message in the request body.

See a more detailed description of all Tunetoo API requests

Request endpoint

All API requests have to be sent to this URL:

https://api.tunetoo.com/v1/

Request parameters

Some mandatory parameters, such as object identifiers, need to be included in the request URL:

GET /orders/321

As stated previously, for POST requests, the message can be sent in JSON format in the request body:

POST /orders

            
              {
                "external": {
                  "id": 1,
                  "options": [
                    {
                      "name": "commande-tunetoo",
                      "value": "Commande Tunetoo"
                    },
                    {
                      "name": "boutique-api",
                      "value": "Boutique API"
                    }
                  ]
                },
                "shipping_address": {
                  "first_name": "Hewitt",
                  "last_name": "Santos",
                  "address1": "242 Remsen Avenue",
                  "address2": "",
                  "city": "Bagtown",
                  "country": "France",
                  "country_code": "FR",
                  "zip": 75001,
                  "phone": "0611223344",
                  "email": "hewitt@santos.fr"
                },
                "items": [
                  {
                    "external": {
                      "id": 26,
                      "options": [
                        {
                          "name": "tshirt",
                          "value": "T-Shirt"
                        },
                        {
                          "name": "homme",
                          "value": "Homme"
                        },
                        {
                          "name": "colrond",
                          "value": "Col Rond"
                        }
                      ]
                    },
                    "sku_base": "TSH180_856_M",
                    "quantity": 15,
                    "files" : [
                      {
                        "zone": "front",
                        "type": "image",
                        "value": "https://www.tunetoo.com/images/impression.png",
                        "collar_distance": "3"
                      }
                    ]
  
                  }
                ]
              }

Response

The response body is always a JSON object including the action's result. HTTP status code 200 OK will be sent if the request is successful.

If the API call is not successful, the HTTP response code will not be in the 2xx range. A status attribute contained in data.

An error description will be provided in the message attribute.

In general, response codes in the 4xx range indicate an error that resulted from the provided information (invalid auhentification, required parameters missing, etc.). 5xx codes 5xx indicate an error with Tunetoo's servers.

Tunetoo API

Orders

Three different requests are available regarding your Tunetoo orders:

List orders

GET /orders

Returns the complete list of all your Tunetoo orders.

Data format (response)

                
                  [
                    {
                      "id": 0,
                      "external": {
                        "id": 0,
                        "options": [
                        {
                          "name": "string",
                          "value": "string"
                        },
                        {
                          "name": "string",
                          "value": "string"
                        }
                        ]
                      },
                      "status": "fulfilled",
                      "created_at": "2018-03-26T17:41:36",
                      "updated_at": "2018-03-26T17:41:36",
                      "fulfillments": [
                      {
                        "tracking_url": "https://tracking-company.com/tracking?code=1EXAMPLE1234567",
                        "tracking_number": "1EXAMPLE1234567",
                        "company": "Tracking company",
                        "date": "2018-03-27 10:19:18",
                        "products": [
                        {
                          "id": 1,
                          "quantity": 15,
                          "sku": "111111_3"
                        }
                        ]
                      }
                      ],
                      "shipping_address": {
                        "first_name": "Hewitt",
                        "last_name": "Santos",
                        "company": "",
                        "address1": "242 Remsen Avenue",
                        "address2": "",
                        "city": "Bagtown",
                        "country": "France",
                        "country_code": "FR",
                        "zip": "75001",
                        "phone": "0611223344",
                        "email": "hewitt@santos.fr"
                      },
                      "billing_address": {
                        "first_name": "",
                        "last_name": "",
                        "company": "",
                        "address1": "",
                        "address2": "",
                        "city": "",
                        "country": "",
                        "country_code": null,
                        "zip": ""
                      },
                      "items": [
                      {
                        "id": 1,
                        "external": {
                          "id": 125,
                          "options": []
                        },
                        "quantity": 15,
                        "price": 10.2,
                        "sku_base": "TSH180_856_M",
                        "sku": "111111_3"
                      }
                      ],
                      "price": {
                        "subtotal": 61.20,
                        "shipping": 0,
                        "tax": 11.70,
                        "total": 70.19
                      },
                      "currency": "EUR"
                    },
                    {
                      "id": 0,
                      "external": {
                        "id": 0,
                        "options": [
                        {
                          "name": "string",
                          "value": "string"
                        },
                        {
                          "name": "string",
                          "value": "string"
                        }
                        ]
                      },
                      "status": "awaiting_payment",
                      "created_at": "2018-03-26T17:41:38",
                      "updated_at": "2018-03-26T17:41:38",
                      "fulfillments": [
                      ],
                      "shipping_address": {
                        "first_name": "Hewitt",
                        "last_name": "Santos",
                        "company": "",
                        "address1": "242 Remsen Avenue",
                        "address2": "",
                        "city": "Bagtown",
                        "country": "France",
                        "country_code": "FR",
                        "zip": "75001",
                        "phone": "0611223344",
                        "email": "hewitt@santos.fr"
                      },
                      "billing_address": {
                        "first_name": "",
                        "last_name": "",
                        "company": "",
                        "address1": "",
                        "address2": "",
                        "city": "",
                        "country": "",
                        "country_code": null,
                        "zip": ""
                      },
                      "items": [
                      {
                        "id": 2,
                        "external": {
                          "id": 36,
                          "options": []
                        },
                        "quantity": 1,
                        "price": 4.6,
                        "sku_base": "TSH180_856_M",
                        "sku": "100000_3"
                      }
                      ],
                      "price": {
                        "subtotal": 4.6,
                        "shipping": 4.9,
                        "tax": 0,
                        "total": 9.5
                      },
                      "currency": "EUR"
                    }
                  ]

Filtering is now available by order status (status) and order creation date (created_at). See request examples below:

GET /orders?created_at=2018-06-22

GET /orders?created_at=2018-06-22&status=in_process

Get order data

GET /orders/{id}

Returns order data by ID.

Data format (response)

                
                  {
                    "id": 0,
                    "external": {
                        "id": 0,
                        "options": [
                            {
                                "name": "string",
                                "value": "string"
                            },
                            {
                                "name": "string",
                                "value": "string"
                            }
                        ]
                    },
                    "status": "awaiting_payment",
                    "created_at": "2018-03-26T17:41:36",
                    "updated_at": "2018-03-26T17:41:36",
                    "fulfillments": [
                        {
                            "tracking_url": "https://tracking-company.com/tracking?code=1EXAMPLE1234567",
                            "tracking_number": "1EXAMPLE1234567",
                            "company": "Tracking company",
                            "date": "2018-03-27 10:19:18",
                            "products": [
                                {
                                    "id": 1,
                                    "quantity": 15,
                                    "sku": "111111_3"
                                }
                            ]
                        }
                    ],
                    "shipping_address": {
                        "first_name": "Hewitt",
                        "last_name": "Santos",
                        "company": "",
                        "address1": "242 Remsen Avenue",
                        "address2": "",
                        "city": "Bagtown",
                        "country": "France",
                        "country_code": "FR",
                        "zip": "75001",
                        "phone": "0611223344",
                        "email": "hewitt@santos.fr"
                    },
                    "billing_address": {
                        "first_name": "",
                        "last_name": "",
                        "company": "",
                        "address1": "",
                        "address2": "",
                        "city": "",
                        "country": "",
                        "country_code": null,
                        "zip": ""
                    },
                    "items": [
                        {
                            "id": 1,
                            "external": {
                                "id": 125,
                                "options": []
                            },
                            "quantity": 15,
                            "price": 10.2,
                            "sku_base": "TSH180_856_M",
                            "sku": "111111_3"
                        }
                    ],
                    "price": {
                        "subtotal": 61.20,
                        "shipping": 0,
                        "tax": 11.70,
                        "total": 70.19
                    },
                    "currency": "EUR"
                  }

Create a new order

POST /orders

Creates a new order.

Data format (request)

                
                  {
                    "external": {
                      "id": 123,
                      "options": [
                        {
                          "name": "string",
                          "value": "string"
                        },
                        {
                          "name": "string",
                          "value": "string"
                        }
                      ]
                    },
                    "shipping_address": {
                      "first_name": "Hewitt",
                      "last_name": "Santos",
                      "company": "Une Société S.A.",
                      "address1": "242 Remsen Avenue",
                      "address2": "",
                      "city": "Bagtown",
                      "country": "France",
                      "country_code": "FR",
                      "zip": 75001,
                      "phone": "0611223344",
                      "email": "hewitt@santos.fr"
                    },
                    "items": [
                      {
                        "external": {
                          "id": 125,
                          "options": [
                            {
                              "name": "minim",
                              "value": "consectetur"
                            }
                          ]
                        },
                        "sku_base": "TSH180_856_M",
                        "quantity": 15,
                        "files" : [
                          {
                            "zone": "front",
                            "type": "image",
                            "value": "https://www.example.com/images/image.png",
                            "collar_distance": "3"
                          }
                        ]
  
                      }
                    ]
                  }

Data format (response)

                
                  {
                    "id": 10,
                    "external": {
                        "id": 123,
                        "options": [
                            {
                                "name": "string",
                                "value": "string"
                            },
                            {
                                "name": "string",
                                "value": "string"
                            }
                        ]
                    },
                    "status": "awaiting_payment",
                    "created_at": "2018-03-26T17:41:36",
                    "updated_at": "2018-03-26T17:41:36",
                    "fulfillments": [
                        {
                            "tracking_url": "https://tracking-company.com/tracking?code=1EXAMPLE1234567",
                            "tracking_number": "1EXAMPLE1234567",
                            "company": "Tracking company",
                            "date": "2018-03-27 10:19:18",
                            "products": [
                                {
                                    "id": 1,
                                    "quantity": 15,
                                    "sku": "111111_3"
                                }
                            ]
                        }
                    ],
                    "shipping_address": {
                        "first_name": "Hewitt",
                        "last_name": "Santos",
                        "company": "Une Société S.A.",
                        "address1": "242 Remsen Avenue",
                        "address2": "",
                        "city": "Bagtown",
                        "country": "France",
                        "country_code": "FR",
                        "zip": "75001",
                        "phone": "0611223344",
                        "email": "hewitt@santos.fr"
                    },
                    "billing_address": {
                        "first_name": "",
                        "last_name": "",
                        "company": "",
                        "address1": "",
                        "address2": "",
                        "city": "",
                        "country": "",
                        "country_code": null,
                        "zip": ""
                    },
                    "items": [
                        {
                            "id": 1,
                            "external": {
                                "id": 125,
                                "options": [
                                  {
                                    "name": "minim",
                                    "value": "consectetur"
                                  }
                                ]
                            },
                            "quantity": 15,
                            "price": 10.2,
                            "sku_base": "TSH180_856_M",
                            "sku": "111111_3"
                        }
                    ],
                    "price": {
                        "subtotal": 61.20,
                        "shipping": 0,
                        "tax": 11.70,
                        "total": 70.19
                    },
                    "currency": "EUR"
                  }

Order statuses

awaiting_payment - The order is created but yet submitted for production. You need to pay it via our site..

in_process - The order is being fulfilled..

partially_fulfilled - The order has been partially fulfilled. Some items are shipped already, the rest will follow..

fulfilled - All items have been shipped successfully..

cancelled - The order has been cancelled..

Pay an order group on our site

Production for orders transmitted via the API will not be launched until their payment is approved. You can settle order payment from your Tunetoo account.

Specifying products

The following is necessary for a product: an SKU (Stock-keeping Unit) of the base product, a list of files to be printed (including which face, type, the URL of the image and the distance in cm from the product's collar), and its quantity.

Product example in JSON:

            
              {
               "external": {
                 "id": 2,
                 "options": [
                   {
                     "name": "dolore",
                     "value": "cupidatat"
                   },
                   {
                     "name": "anim",
                     "value": "ut"
                   },
                   {
                     "name": "anim",
                     "value": "exercitation"
                   }
                 ]
               },
               "sku_base": "TSH180_856_XL",
               "quantity": 6,
               "price": 15.95,
               "files" : [
                 {
                   "zone": "back",
                   "type": "image",
                   "value": "https://www.example.com/images/image-300dpi.png",
                   "collar_distance": "5.5"
                 }
               ]
             }

sku_base: Product SKU (see Tunetoo product catalogue). It is composed of the product's model SKU (in our example, TSH180 is a 180g Men's T-shirt), its color (ex: 856, white in our catalogue) and its size (XL).
external (optional): Optional data alowing you to link your Tunetoo product with an ID from your own system. Product IDs must be unique within a store. An option list (name and value) can also be included in this attribute.
quantity: The amount of the identical item (by color, size and customisation) to be included in the order.
files: Image files composing the product's customisation. To be specified: zone ("front" or "back" indicating whether the image is placed on the front or the back of the article), type ("image"), value (the image URL, 300dpi resolution and actual printing size required) and collar_distance (distance in cm to place the image starting from the product's collar).

Please note the response to a order creation POST request contains a different SKU thatn the base product's, called sku. This identifies your personnalised item according to your files and parameters.

Product catalogue

Hoodie Men : JH001

Color	Color SKU	Size SKU
Light Royal Blue	476	XS, S, M, L, 4XL
Wine	893	XS, M, L, XL, XXL, 4XL
Forest Green	301	XS, S, M, L, XL, XXL, 3XL, 4XL
Dark Grey	230	XS, S, M, L, XL, XXL, 4XL
Yellow	895	XS, S, M, L, XL, XXL, 3XL, 4XL
Red	678	XS, S, M, L, XL, XXL, 4XL
Oxford Grey	621	S, M, L, XL, XXL, 3XL, 4XL
Black	49	XS, S, M, L, XL, XXL, 3XL, 4XL
Orange	609	S, M, L, XL, XXL, 4XL
Navy	542	XS, S, M, L, XL, XXL, 3XL
White	856	XS, S, M, L, XL, XXL, 3XL, 4XL
Ash Heather		S, M, XL, XXL, 3XL, 4XL
Chocolate	199	XS, S, M, XL, XXL, 3XL, 4XL
Dark Khaki	251	XS, S, M, 4XL
Fuchsia	319	S, M, L, XL, XXL, 3XL, 4XL
Kelly Green	436	XS, XL, XXL, 3XL, 4XL
Light Sand	478	XS, S, 3XL, 4XL
Lime	483	XS, S, M, L, XL, XXL, 3XL, 4XL
Purple	663	S, M, L, XL, XXL, 3XL, 4XL
Sky Blue	750	3XL, 4XL
Tropical Blue	818	L, XL, XXL, 3XL, 4XL
Camel	177	XS, XXL, 3XL, 4XL
Candyfloss		XS, M, L, XL, XXL, 3XL, 4XL
Caper Green		XS
Cherry Red	197	XS, XL, 3XL, 4XL
Dark Mustard		XS, L, XL, XXL, 3XL, 4XL
Dusty Purple		XS, S, M, L, XL, XXL, 3XL, 4XL
Earthy Green		XS, S, M, L, XL, XXL, 3XL, 4XL
Emerald Green		XS, XL, XXL, 3XL, 4XL
Grey Camouflage		XS, S, M, L, XL, XXL, 3XL, 4XL
Hawaii Blue		XS, S, M, L, XL, 3XL, 4XL
Ink Blue		XS, 3XL, 4XL
Moka Brown		XS, XL, XXL, 3XL, 4XL
Olive Camouflage		XS, S, M, L, XL, XXL, 3XL, 4XL
Orion Blue		XS, 3XL, 4XL
Pale Pink	631	L, XL, XXL, 3XL, 4XL
Peach	639	XS, S, M, L, XL, XXL, 3XL, 4XL
Pistachio	651	XS, S, M, L, XL, XXL, 3XL, 4XL
Pumpkin		XS, S, M, L, XL, XXL, 3XL, 4XL
Storm Grey	793	XS, S, M, L, XL, XXL, 3XL, 4XL
Straw Yellow	794	XS, S, M, L, XL, XXL, 3XL, 4XL
Sweet Grey		XS, S, M, L, XL, XXL, 3XL, 4XL
True Coral		XS, M, L, XL, XXL, 3XL, 4XL
Apple Green		XS, M, L, XL, XXL, 3XL, 4XL
Green Olive	346	XS, S, M, 3XL, 4XL

T-shirt Women Long sleeve : K383

Color	Color SKU	Size SKU
White	856	S, M, L, XL, XXL
Yellow	895	S, M, L, XL, XXL, 3XL
Red	678	S, M, L, XL, XXL
Dark Khaki	251	S, L, XXL, 3XL
Navy	542	S, M, L, XL, XXL, 3XL
Chocolate	199	S, L, XL, XXL
Forest Green	301	S, M, L, XL, XXL, 3XL
Kelly Green	436	S, M, L, XL, 3XL
Lime	483	S, M, XL, XXL, 3XL
Oxford Grey	621	S, L, XL, XXL, 3XL
Dark Grey	230	S, M, L, XL, XXL, 3XL
Black	49	S, M, L, XL, XXL, 3XL
Tropical Blue	818	S, M, L, XL, XXL, 3XL
Wine	893	S, M, L, XL, XXL, 3XL
Fuchsia	319	S, M, L, XL, XXL, 3XL
Orange	609	S, M, L, XXL, 3XL
Light Royal Blue	476	S, M, L, XL, XXL, 3XL
Sky Blue	750	S, M, L, XL, XXL, 3XL
Purple	663	S, M, L, XL, XXL, 3XL
Light Sand	478	S, M, L, XL, XXL, 3XL

Tee Shirt Women Classic 150gr : CGTW02TC

Color	Color SKU	Size SKU
White	856	XS, S, M, L, XL, XXL, 3XL
Sand	731	XS, S, L, XL, XXL
Royal Blue	710	XS, S, M, L, XL, XXL, 3XL
Red	678	XS, S, M, L, XL, XXL, 3XL
Orange	609	XS, S, M, L, XL, XXL
Natural	537	XS, M, L, XL, XXL
Dark Grey	230	XS, S, M, L, XL, XXL
Burgundy	162	XS, S, M, L, XL, XXL
Bottle Green	137	XS, S, M, L, XL, XXL
Sky Blue	750	XS, S, M, L, XL, XXL
Black	49	XS, S, M, L, XL, XXL, 3XL
Kelly Green	436	XS, S, L, XL, XXL
Apricot	19	XS, L, XL, XXL
Atoll	35	XS, S, M, L, XL, XXL
Azure	900	XS, S, M, L, XL, XXL
Bear Brown	43	XS, S, M, L, XL, XXL
Cobalt Blue	916	XS, S, M, L, XL, XXL
Deep Red	258	XS, S, M, L, XL, XXL
Denim	261	XS, S, M, L, XL, XXL
Diva Blue	269	XS, S, L, XL, XXL
Electric Blue	917	XS, S, M, L, XL, XXL
Fire Red	289	XS, S, M, L, XL, XXL
Fuchsia	319	XS, S, M, L, XL, XXL
Gold	336	XS, S, M, L, XL, XXL
Light Navy	472	XS, S, M, L, XL, XXL
Millennial Khaki	918	XS, S, M, L, XL, XXL
Millennial Pink	919	XS, S, M, L, XL, XXL
Orchid Green	920	XS, S, M, L, XL, XXL
Pistachio	651	XS, S, M, L, XL, XXL
Radiant Purple	921	XS, S, M, L, XL, XXL
Real Turquoise	677	XS, S, M, L, XL, XXL
Solar Yellow	922	XS, S, M, L, XL, XXL
Sport Grey	775	XS, S, M, L, XL, XXL, 3XL
Turquoise	823	XS, S, M, L, XL, XXL
Urban Black	923	XS, S, M, L, XL, XXL
Urban Khaki	924	XS, S, M, L, XL, XXL
Urban Navy	925	XS, S, M, L, XL, XXL, 3XL
Urban Purple	926	XS, S, M, L, XL, XXL
Ash	32	XS, S, M, L, XL, XXL
Used Black	827	XS, S, M, L, XL, XXL

Sweatshirt Women round neck : JH036

Color	Color SKU	Size SKU
Wine	893	M, L, XL, XXL
Light Royal Blue	476	XS, S, M, L, XL, XXL, 3XL, 4XL
Oxford Navy	623	XS, S, M, L, XL, XXL, 3XL
Burgundy	162	M, L, XL, XXL
Jet Black	421	XS, S, M, L, XL, 3XL, 4XL
Arctic White	25	XS, S, M, L, XL, XXL, 3XL, 4XL
Heather Grey	380	XS, S, M, L, XL, XXL, 3XL, 4XL

Hoodie Women : JH01F

Color	Color SKU	Size SKU
Arctic White	25
Red Hot Chilli	692
Burgundy	162
Plum	656
Candyfloss Pink	180
Hot Pink	404
Purple	663
Ash	32
Heather Grey	380
Charcoal	188
Jet Black	421
Fire Red	289
Orange Crush	617
Sun Yellow	799
Bottle Green	137
Kelly Green	436
Lime	483
Jade	412
Sky Blue	750
Turquoise Surf	825
Hawaiian Blue	363
Sapphire Blue	737
Royal Blue	710
New French Navy	583
Airforce Blue	2
kariban Wine	960	XS, S, M, L, XL, XXL
kariban Light Royal Blue	954	S, XXL
Kariban Black	951	XS, S, M, L, XL, XXL
Kariban Dark Grey	952	XS, S, M, L, XXL
Kariban Forest Green	953	XS, S, M, L, XL, XXL
Kariban Navy	955	XS, S, M, L, XXL
Kariban Orange	956	XS, S, L, XXL
Kariban Oxford Grey	957	XS, S, M, L, XL, XXL
Kariban Red	958	XS, S, M, L, XL, XXL
Kariban White	959	XS, S, M, L, XL, XXL
Kariban Yellow	961	XS, S, M, XL, XXL

Sweatshirt crew neck Unisex : JH030

Color	Color SKU	Size SKU
Chocolate	199	XS, L, XL, XXL, 3XL, 4XL
Ash Heather		XS, S, M, L, XL, XXL, 4XL
Fuchsia	319	XS, M, L, XL, XXL, 3XL, 4XL
Kelly Green	436	XS, S, M, L, XL, XXL, 3XL, 4XL
Light Sand	478	XL, XXL, 3XL, 4XL
Lime	483	XS, M, L, XL, XXL, 3XL, 4XL
Purple	663	XS, S, M, L, XL, XXL, 3XL, 4XL
Tropical Blue	818	XS, M, L, XL, XXL, 3XL, 4XL
Dark Khaki	251	XS, M, L, XL, 3XL, 4XL
Sky Blue	750	XS, S, M, L, XL, XXL, 3XL, 4XL
Apple Green		XS, M, L, XL, XXL, 3XL, 4XL
Camel	177	XS, L, XL, XXL, 3XL, 4XL
Candyfloss		XS, M, L, XL, XXL, 3XL, 4XL
Caper Green		XS, S, M, L, XL, XXL, 3XL, 4XL
Cherry Red	197	XS, M, L, XL, XXL, 3XL, 4XL
Dark Mustard		XS, S, M, L, XL, XXL, 3XL, 4XL
Dusty Purple		S, M, L, XL, XXL, 3XL, 4XL
Earthy Green		XS, S, M, L, XL, XXL, 3XL, 4XL
Emerald Green		XS, M, L, XL, XXL, 3XL, 4XL
Green Olive	346	XS, S, M, L, XL, XXL, 3XL, 4XL
Hawaii Blue		XS, M, L, XL, XXL, 3XL, 4XL
Ink Blue		XS, M, L, XL, XXL, 3XL, 4XL
Moka Brown		XS, S, M, L, XL, XXL, 3XL, 4XL
Orion Blue		XS, M, L, XL, XXL, 3XL, 4XL
Pale Pink	631	L, XL, XXL, 3XL, 4XL
Peach	639	XS, S, M, L, XL, XXL, 3XL, 4XL
Pistachio	651	XS, S, M, L, XL, XXL, 3XL, 4XL
Pumpkin		XS, S, M, L, XL, XXL, 3XL, 4XL
Storm Grey	793	XS, S, M, L, XL, 3XL, 4XL
Straw Yellow	794	XS, M, L, XL, XXL, 3XL, 4XL
Sweet Grey		XS, S, M, L, XL, XXL, 3XL, 4XL
True Coral		M, L, XL, XXL, 3XL, 4XL
Wine	893	M, L, XL, XXL
Light Royal Blue	476	XS, S, M, L, XL, XXL, 3XL, 4XL
Black	49	XS, S, M, L, XL, 3XL, 4XL
Dark Grey	230	XS, S, M, L, XL
Forest Green	301	XS, S, M, L, XL, 3XL, 4XL
Navy	542	XS, S, M, L, XL, XXL, 3XL
Orange	609	XS, S, M, L, XL, XXL, 4XL
Oxford Grey	621	XS, S, M, L, XL, XXL, 3XL, 4XL
Red	678	S, M, L, XL, XXL, 3XL, 4XL
White	856	XS, S, M, L, XL, XXL, 3XL, 4XL
Yellow	895	XS

Hoodie Kids : JH01J

Color	Color SKU	Size SKU
Wine	893	12Y14, 4Y6, 6Y8, 8Y10, 10Y12
White	856	4Y6
Yellow	895	12Y14, 4Y6, 6Y8, 8Y10, 10Y12
Black	49	4Y6, 6Y8, 10Y12
Red	678	12Y14, 4Y6, 8Y10, 10Y12
Light Royal Blue	476	12Y14, 4Y6, 6Y8, 8Y10, 10Y12
Oxford Grey	621	12Y14, 4Y6, 6Y8, 8Y10, 10Y12
Orange	609	12Y14, 4Y6, 6Y8, 8Y10, 10Y12
Navy	542	12Y14, 4Y6, 6Y8, 8Y10, 10Y12
Dark Grey	230	12Y14, 6Y8, 8Y10, 10Y12
Forest Green	301	12Y14, 10Y12

Baby Bodysuit Short Sleeves : K831

Color	Color SKU	Size SKU
White	856	3M, 6M, 9M, 12M, 18M, 24M
Sky Blue	750	3M, 6M, 9M, 12M, 18M, 24M
Red	678	3M, 6M, 9M, 12M
Oxford Grey	621	3M, 6M, 9M, 12M, 18M, 24M
Navy	542	3M, 6M, 9M, 12M, 18M
Fuchsia	319	3M, 6M, 9M, 12M, 18M, 24M
Black	49	3M, 6M, 9M, 12M, 18M, 24M

T-Shirt Baby Short Sleeve : LW20T

Color	Color SKU	Size SKU
Navy	542
Pale Pink	631
White	856
Pale Blue	629

Tee shirt girl short sleeves round neck Sofspun : SS418

Color	Color SKU	Size SKU
Azure Blue	901
Black	49
Burgundy	162
Fuchsia	319
Heather Grey	380
Kelly Green	436
Light Graphite	902
Lime	483
Navy	542
Orange	609
Red	678
Royal Blue	710
Sunflower	801
White	856
Yellow	895
Zinc	899

Tee Shirt Baby short-sleeved with pressure : K363

Color	Color SKU	Size SKU
White	856	3M, 6M, 9M, 12M, 18M, 24M, 36M
Black	49	3M, 6M, 9M, 12M, 18M, 24M, 36M
Fuchsia	319	3M, 6M, 9M, 12M, 18M, 24M, 36M
Navy	542	3M, 6M, 9M, 12M, 18M, 24M, 36M
Red	678	3M, 9M, 12M, 18M, 36M
Sky Blue	750	3M, 6M, 9M, 12M, 18M, 36M

Tee shirt Kids long sleeves : SS007

Color	Color SKU	Size SKU
White	856	3Y4, 7Y8, 9Y11, 12Y13
Heather Grey	380	5Y6, 7Y8, 9Y11, 12Y13, 14Y15
Red	678	3Y4, 5Y6, 9Y11, 12Y13, 14Y15
Royal Blue	710	3Y4, 5Y6, 7Y8, 9Y11, 12Y13, 14Y15
Black	49	3Y4, 5Y6, 7Y8, 9Y11, 12Y13, 14Y15
Deep Navy	257	3Y4, 5Y6, 7Y8, 9Y11, 12Y13, 14Y15
Dark Heather Grey	243

Tank Top Men 100% cotton : SC294

Color	Color SKU	Size SKU
White	856	S, M, L, XL, XXL, 3XL, 4XL, 5XL
Heather Grey	380	S, M, L, XL, XXL, 3XL, 4XL, 5XL
Red	678	S, M, L, XL, XXL, 3XL
Royal Blue	710	S, M, L, XL, XXL, 3XL
Black	49	S, M, L, XL, XXL, 3XL, 4XL, 5XL
Deep Navy	257	S, M, L, XL, XXL, 3XL

Baby Sleeper long sleeves Contrast : LW53T

Color	Color SKU	Size SKU
Pale Blue / White	630	, 3M6, 6M12, 12M18
Pale Pink / White	633
White / White	892	, 3M6, 6M12, 12M18

Tee-shirt Woman V-neck short sleeves : K390

Color	Color SKU	Size SKU
White	856
Wine	893
Tropical Blue	818
Sky Blue	750
Red	678
Oxford Grey	621
Orange	609
Navy	542
Light Royal Blue	476
Fuchsia	319
Forest Green	301	S, M, L, XL, XXL, 3XL
Dark Grey	230
Yellow	895
Black	49
Kelly Green	436

Tee Shirt Kid Original : SS088

Color	Color SKU	Size SKU
Black	49	3Y4, 5Y6, 7Y8, 9Y11, 12Y13, 14Y15
Azure Blue	901	3Y4, 5Y6, 7Y8, 9Y11, 12Y13, 14Y15
Bottle Green	137	3Y4, 5Y6, 7Y8, 9Y11, 12Y13, 14Y15
Brick Red	140	3Y4, 5Y6, 7Y8, 9Y11, 12Y13, 14Y15
Burgundy	162	5Y6, 7Y8, 9Y11, 12Y13, 14Y15
Classic Olive	903	3Y4, 5Y6, 7Y8, 9Y11, 12Y13, 14Y15
Deep Navy	257	3Y4, 5Y6, 7Y8, 9Y11, 12Y13, 14Y15
Fuchsia	319	3Y4, 5Y6, 7Y8, 9Y11, 12Y13, 14Y15
Heather Grey	380	3Y4, 5Y6, 7Y8, 12Y13, 14Y15
Kelly Green	436	5Y6, 7Y8, 9Y11, 12Y13, 14Y15
Light Graphite	902	3Y4, 5Y6, 7Y8, 9Y11, 12Y13, 14Y15
Lime	483	3Y4, 5Y6, 7Y8, 9Y11, 12Y13, 14Y15
Orange	609	3Y4, 5Y6, 7Y8, 9Y11, 12Y13, 14Y15
Purple	663	7Y8, 9Y11, 12Y13, 14Y15
Red	678	3Y4, 5Y6, 7Y8, 9Y11, 12Y13, 14Y15
Royal Blue	710	5Y6, 7Y8, 12Y13
Sky Blue	750	7Y8, 12Y13, 14Y15
Sunflower	801	3Y4, 5Y6, 7Y8, 9Y11, 12Y13, 14Y15
Yellow	895	3Y4, 5Y6, 7Y8, 9Y11, 12Y13, 14Y15
White	856	3Y4, 5Y6, 7Y8, 9Y11, 12Y13, 14Y15

Tee Shirt Men Full Cut Screen Stars Original : SC6

Color	Color SKU	Size SKU
White	856	S, M, L, XL, 3XL, 4XL, 5XL
Sky Blue	750	S, M, L, XL, XXL, 3XL
Royal Blue	710	S, M, L, XL, XXL, 3XL
Red	678	S, M, L, XL, XXL, 3XL
Orange	609	S, M, L, XL, XXL, 3XL
Heather Grey	380	S, M, XL, XXL, 3XL
Fuchsia	319	S, M, L, XL, XXL, 3XL
Burgundy	162	S, M, L, XL, XXL, 3XL
Bottle Green	137	S, M, L, XL, XXL, 3XL
Azur Blue	39	S, M, L, XL, XXL, 3XL
Yellow	895	S, M, L, XL, XXL, 3XL
Black	49	S, M, L, XL, 3XL, 4XL, 5XL
Sunflower Yellow	904	S, M, L, XL, XXL, 3XL
Kelly Green	436	S, M, L, XL, XXL, 3XL
Brick Red	140	S, M, L, XL, XXL, 3XL
Classic Olive	903	S, M, L, XL, XXL, 3XL
Deep Navy	257	S, M, L, XL, XXL, 3XL
Light Graphite	902	S, M, L, XL, XXL, 3XL
Lime	483	S, L, XL, XXL, 3XL
Purple	663	S, L, XL, 3XL

Top Tank Women Cotton : SC61376

Color	Color SKU	Size SKU
White	856	XS, S, M, L, XL, XXL
Heather Grey	380
Red	678	XS, S, M, L, XL, XXL
Deep Navy	257
Black	49

Garden or Sommelier Apron with Pocket : K885

Color	Color SKU	Size SKU
Sky Blue	750
Marsala
Light khaki	471
Mustard	536
Fuchsia	319
Cacao
Camel	177
Orange	609
Light Grey	455
Wine	893
Kelly Green	436
Bottle Green	137
Lagoon	446
Royal Blue	710
Navy	542
Beige	44
Yellow	895
Chocolate	199
Red	678
Dark Pink	254
Black	49
Dark Grey	230
Lime	483
Green Olive	346
Tropical Blue	818
Burnt Orange	176
Purple	663
White	856
Denim	261
Angora
Olive Camouflage
Black Denim	109

Baby T-shirt with press-studs long sleeve : BZ011

Color	Color SKU	Size SKU
White	856
Bubblegum Pink	159
Dusty Blue	274
Powder Pink	659
Black	49
Nautical Navy	541
Red	678

Tee shirt Men Original long sleeve : SS069

Color	Color SKU	Size SKU
White*	927
Black*	928
Deep Navy	257
Heather Grey*	929
Light Graphite	902
Red	678
Royal Blue	710

Sweatshirt crew neck Kids : JH30J

Color	Color SKU	Size SKU
Forest Green	301	4Y6
Orange	609	6Y8, 8Y10, 10Y12
Light Royal Blue	476	12Y14, 4Y6, 6Y8, 8Y10, 10Y12
Black	49	4Y6, 6Y8, 8Y10
Wine	893	12Y14, 4Y6, 6Y8, 8Y10
Red	678	12Y14, 4Y6, 6Y8, 8Y10, 10Y12
Navy	542	4Y6, 6Y8, 10Y12
Yellow	895	12Y14, 6Y8, 8Y10, 10Y12
Dark Grey	230	12Y14, 4Y6, 6Y8, 8Y10, 10Y12
Oxford Grey	621	12Y14, 4Y6, 6Y8, 8Y10, 10Y12
White	856	4Y6, 6Y8

Ceramic Mug : MUG

Color	Color SKU	Size SKU
BLANC	119	TU

Tote Bag Stanley Stella : STAU760

Color	Color SKU	Size SKU
Heather Grey	380	TU
Natural	537	TU
Black	49	TU
Midnight Blue	964	TU

Unisex T-shirt 180G/M² Creator : STTU755

Color	Color SKU	Size SKU
White	856	XXS, XS, S, M, L, XL, XXL, 3XL, 4XL, 5XL
Off White	598	XS, L, XL
Vintage White	847	XXS, S, L, XL, 3XL
Cream Heather Grey	224
Heather Grey	380	XXS, XS, S, M, L, XL, XXL, 5XL
Mid Heather Grey	518	XXS, XS, S, M, L, XL, XXL
Anthracite	6	XXS, M, L, 3XL
India Ink Grey	408	XXS, XS, S, M, XXL
Dark Heather Grey	243	XXS, XS, S, M, L, XL, XXL, 3XL
Black	49	XS, S, 3XL, 5XL
Bright Orange	141
Cotton Pink	934	XXS, XS, S, M, L, XL, XXL
Red	678	XS, S, M, L, XL, XXL, 3XL, 4XL, 5XL
Bright Red	143
Burgundy	162	XXS, S
Royal Blue	710	XXS, S, M, L, XL, XXL
Black Heather Blue	114
French Navy	307	XXS, M, XXL, 5XL
Mid Heather Blue	515
Sky blue	750	XXS, S, M, L, XL, XXL
Citadel Blue	205	XXS, XS, S, M, XL, XXL
Stargazer	790	XXS, XS, S, M, XXL
Ocean Depth	597	XXS, XS
Caribbean Blue	185
Fresh Green	318
Bottle Green	137	XXS, XS, S, XXL, 5XL
British Khaki	153
Khaki	442	XXS, XS, S, M, XL, XXL
Golden Yellow	338	XXS, XS, S, M, L, XL, XXL, 3XL
Spectra Yellow	773	XXS, S, M, L, XL, XXL
Camel	177
Desert Dust	935	XXS, XS, S, M, L
Heather Sand	948
Dark Heather Blue	240
Opal	608
Majorelle Blue	963	XXS, XS, S, M, L, XL, XXL
Glazed Green	944	M, L
Mid Heather Khaki	520
Natural Raw		S, XL, XXL, 3XL
Sage	728	XXS, XS, S, M, XL, XXL
Ochre		XXS, XS, S, M, L, XL, XXL
Stem Green
Teal Monstera		XXS, XS, S, M, L
Serene Blue
Bright Blue
Candy Pink	179
Rose Clay
Indigo Hush
Hibiscus Rose
Lavender	448	XXS, S, M, L, XL, XXL, 3XL
Orchid Flower
Deck Chair Red
Go Green
Fraiche Peche
Day Fall
Butter		XXS, XS, S, M, L, XL, XXL, 3XL
Mid Heather Green	517
Aloe		XXS, XS, S, M, L, XL
Atlantic Blue
Worker Blue
Red Earth
Kaffa Coffee
Heather Rainbow
Canyon Pink	941

Kids T-shirt Mini Creator : STTK909

Color	Color SKU	Size SKU
White	856	3Y4, 5Y6, 7Y8, 9Y11, 12Y14
Raspberry	674
Anthracite	6
Red	678
Mid Heather Green	517
Mid Heather Red	521
Sky blue	750
Royal Blue	710
Dark Heather Grey	243
Heather Grey	380
French Navy	307	3Y4, 5Y6, 7Y8, 9Y11, 12Y14
Black	49	3Y4, 5Y6, 7Y8, 9Y11, 12Y14
Azur	38
Ocean Depth	597
Caribbean Blue	185
Fresh Green	318
Golden Yellow	338
Chameleon Green	933
Cotton Pink	934
Lavender Dawn	936
Scale Green	938
Cream Heather Pink	225
Mid Heather Blue	515
Black Heather Blue	114
Bright Orange	141
Burgundy	162
Tangerine	966
Geyser Green	943
Majorelle Blue	963
Heather Ice Blue	393
Hibiscus Rose
Orchid Flower

Unisex Crew Neck Sweatshirt 350G/M² Changer : STSU823

Color	Color SKU	Size SKU
White	856	XXS, XS, S, M, L, XL, XXL, 3XL, 4XL, 5XL
Natural Raw		XXS, XS, S, M, L, XL, XXL, 3XL
Hibiscus Rose
Lavender	448
Jojoba
Dusty Mint
Black	49	XXS, XS, S, M, L, XL, 4XL, 5XL
Deep Chocolate	942
Ochre
Bottle Green	137	XXS, XS, S, M, L, XL, 4XL, 5XL
Khaki	442
Stem Green
Teal Monstera
Serene Blue
Sky blue	750
Majorelle Blue	963
India Ink Grey	408
Lava Grey	962
French Navy	307	XXS, XS, S, M, XL, XXL, 3XL, 4XL, 5XL
Burgundy	162
Cotton Pink	934
Canyon Pink	941
Tangerine	966
Bright Red	143
Heather Grey	380	XXS, XS, S, M, L, XL, XXL, 3XL, 4XL, 5XL
Mid Heather Khaki	520
Mid Heather Green	517
Dark Heather Blue	240
Off White	598
Deck Chair Red
Go Green
Fraiche Peche
Butter
Atlantic Blue
Stargazer	790
Worker Blue
Red Earth
Kaffa Coffee

Unisex hoodie sweatshirt Cruiser : STSU822

Color	Color SKU	Size SKU
White	856	XXS, XS, S, M, L, XL, XXL, 4XL, 5XL
Black	49	XXS, XS, S, M, L, XL, XXL
Black Heather Blue	114
French Navy	307	XXS, XS, S, M
Dark Heather Grey	243	XXS, XS, S, M, L, XL, XXL, 3XL
Mid Heather Grey	518
Heather Grey	380
Sage	728
Desert Dust	935	XXS, XS, S, M, L, XL, XXL, 3XL
British Khaki	153
Khaki	442	XXS, L
Mid Heather Khaki	520
Glazed Green	944	XXS, XS, S, M, L, XL
Teal Monstera		XXS, XS, S, M, L, XL, XXL, 3XL
Mid Heather Green	517
Stem Green
Natural Raw		XXS, XS, S, M, L, XL, XXL
Ochre		XXS, XS, S, M, L, XL
Burgundy	162	S, M, L, XL, 4XL, 5XL
Rose Clay
Bright Red	143
Canyon Pink	941	XXS, XS, S, M, L, XL, XXL, 3XL
Cotton Pink	934	XXS, XS, S, M, L, XL, XXL, 3XL
Candy Pink	179
Lavender	448	XXS, XS, S, M, L, XL, XXL
Serene Blue		XXS, XS, S, M, L, XL, XXL, 3XL
Sky blue	750	XXS, XS, S, M, L, XL, XXL, 3XL
Bright Blue
Royal Blue	710	XXS, XS, S, M, L, XL, XXL
Majorelle Blue	963	XXS, XS, S, L, XL, XXL, 3XL
India Ink Grey	408	XXS, XS, S, M, L, XL, XXL, 3XL
Indigo Hush
Orchid Flower
Hibiscus Rose
Deck Chair Red
Go Green
Fraiche Peche
Off White	598	XXS, XS, S, M, L, XL, XXL, 3XL
Day Fall
Butter
Aloe		XXS, XS, S, M, XXL, 3XL
Atlantic Blue		XXS, XS, S, M, L, XL, XXL, 3XL
Stargazer	790	XXS, XS, S, M, L
Worker Blue
Red Earth
Kaffa Coffee		XXS, M, L, XL, 3XL
Heather Rainbow

Webhooks

A webhook is an event notification sent to a URL of your choice. You can configure your webhooks for the following events:

order_change_status: The order status has been updated. The complete order details will be sent to the selected target.
order_fulfilled: The order has been shipped. The fulfillment content, as well as the order ID and external data will be sent to the selected target.
stock_updated: Product stock has been updated. A table containing all product SKUs and their new stock amount will be sent to the selected target.

Webhooks requests:

List webhook configuration

GET /webhooks

Returns the list of webhook events enabled for the store.

Data format (response)

                
                  [
                    {
                        "id": 1,
                        "target": "https://www.example.com/order-change-status.php",
                        "event": "order_change_status"
                    },
                    {
                        "id": 2,
                        "target": "https://www.example.com/order-fulfilled-3.php",
                        "event": "order_fullfilled"
                    },
                    {
                        "id": 3,
                        "target": "https://www.example.com/stockupdated.php",
                        "event": "stock_updated"
                    }
                  ]

Get webhook configuration

GET /webhooks/{id}

Returns configured webhook URL by ID.

Data format (response)

                
                  {
                      "id": 1,
                      "target": "https://www.example.com/order-change-status.php",
                      "event": "order_change_status"
                  }

Set up webhook configuration

POST /webhooks

Allows to enable webhook URL for the store and select the webhook event type that will be sent to this URL. In the event the webhook event type has already been enabled for the store, the webhook URL will be overwritten.

Data format (request)

                
                  {
                    "target": "https://www.test.com/order-fulfilled-new.php",
                    "event": "order_fullfilled"
                  }

Data format (response)

                
                  {
                      "id": 4,
                      "target": "https://www.test.com/order-fulfilled-new.php",
                      "event": "order_fullfilled"
                  }

Disable webhook support

DELETE /webhooks/{id}

Removes the webhook URL and selected event type from the store. Method returns the deleted webhook configuration.

Data format (response)

                
                  {
                      "id": 4,
                      "target": "https://www.test.com/order-fulfilled-new.php",
                      "event": "order_fullfilled"
                  }

Products

All goods sold by Tunetoo are grouped into Products and Variants. A Product describes a specific type, model and manufacturer of the item, while the Variant describes the attributes of the product such as size and color, dimensions, etc.
This entity is meant to enable access to the complete list of products currently available for the API. Important information, such as SKUs for products, color and sizes, as well as stock availability can be accessed via the Product entity.

Get all Product list

GET /products

Returns the list of products available in the Tunetoo API.

Data format (response)

                
                  [
                    {
                      "sku": "JH001",
                      "type": "Sweatshirts",
                      "brand": "Ralawise",
                      "model": "Hoodie Men",
                      "image": "https://www.tunetoo.com/images/produits/base/produit-porte/37857-sweat-shirt-a-capuche-homme-face.png",
                      "description": "The hoodie is a unisex model with a kangaroo pocket. With its trendy cut, it will dress you in all circumstances: at sport, at home or in town. Its fabric (280g / m²) is composed of 80% cotton and 20% polyester which allows it to remain very soft over time. From XS to XXL. Choose from the available colors.",
                      "colors": [
                        {
                          "name": "Hot Chocolate",
                          "sku": "402",
                          "sizes": [
                            {
                              "sku": "XS",
                              "name": "XS",
                              "in_stock": true
                            }
                          ]
                        }
                      ],
                      "variants": [
                        {
                          "sku": "JH001_402_XS",
                          "color": "Hot Chocolate",
                          "size": "XS",
                          "image": "https://www.tunetoo.com/images/produits/base/produit-porte/37836-sweat-shirt-a-capuche-homme-face.png",
                          "in_stock": true
                        }
                      ]
                    }
                  ]