Search.../
  1. Home
  2. Getting Started
  3. Overview
Generate a test token to explore our APIs

Create Product

Creates a new product.

Authorization

This endpoint requires an authorization header - pass the access token from the OAuth installation flow.

Permissions

This endpoint requires the Manage Products permission scope.

POST

https://www.wixapis.com/stores/v1/products

Body Params

NAME
TYPE
DESCRIPTION
product

object

Product information.

Response Object

NAME
TYPE
DESCRIPTION
product

object

Status/Error Codes

The response will include an HTTP status code.

Was this helpful?

Request

curl

Copy Code
1curl -X POST \
2 'https://www.wixapis.com/stores/v1/products' \
3 --data-binary '{
4 "product": {
5 "name": "T-shirt",
6 "productType": "physical",
7 "priceData": {
8 "price": 10.5
9 },
10 "description": "nice summer t-shirt",
11 "sku": "123df",
12 "visible": false,
13 "weight": 0.2,
14 "discount": {
15 "type": "AMOUNT",
16 "value": 1
17 },
18 "manageVariants": true,
19 "productOptions": [
20 {
21 "name": "Size",
22 "choices": [
23 {
24 "value": "S",
25 "description": "S"
26 },
27 {
28 "value": "L",
29 "description": "L"
30 }
31 ]
32 }
33 ]
34 }
35 }' \
36 -H 'Content-Type: application/json' \
37 -H 'Authorization: <AUTH>'

Response

json

1
2{"product": {
3 "id": "e28e4ddd-6ed0-4098-a5e5-cf4bd9c4f7b5",
4 "name": "T-shirt",
5 "slug": "t-shirt-1",
6 "visible": false,
7 "productType": "physical",
8 "description": "nice summer t-shirt",
9 "stock": {
10 "trackInventory": false,
11 "inStock": true
12 },
13 "price": {
14 "currency": "ILS",
15 "price": 10.5,
16 "discountedPrice": 9.5,
17 "formatted": {
18 "price": "10.50 ₪",
19 "discountedPrice": "9.50 ₪"
20 }
21 },
22 "priceData": {
23 "currency": "ILS",
24 "price": 10.5,
25 "discountedPrice": 9.5,
26 "formatted": {
27 "price": "10.50 ₪",
28 "discountedPrice": "9.50 ₪"
29 }
30 },
31 "additionalInfoSections": [],
32 "ribbons": [],
33 "media": {"items": []},
34 "customTextFields": [],
35 "manageVariants": true,
36 "productOptions": [ {
37 "optionType": "drop_down",
38 "name": "Size",
39 "choices": [
40 {
41 "value": "S",
42 "description": "S",
43 "inStock": true,
44 "visible": true
45 },
46 {
47 "value": "L",
48 "description": "L",
49 "inStock": true,
50 "visible": true
51 }
52 ]
53 }],
54 "productPageUrl": {
55 "base": "https://www.itsjusttooeasy123.com/",
56 "path": "/product-page/t-shirt-1"
57 },
58 "numericId": "1567588455405000",
59 "inventoryItemId": "1d71b222-912f-bf67-5a1a-30b4263b084a",
60 "discount": {
61 "type": "AMOUNT",
62 "value": 1
63 },
64 "collectionIds": [],
65 "variants": [
66 {
67 "id": "00000000-0000-0001-0005-93fc95e0514a",
68 "choices": {"Size": "S"},
69 "variant": {
70 "priceData": {
71 "currency": "ILS",
72 "price": 10.5,
73 "discountedPrice": 9.5,
74 "formatted": {
75 "price": "10.50 ₪",
76 "discountedPrice": "9.50 ₪"
77 }
78 },
79 "weight": 10,
80 "visible": true
81 }
82 },
83 {
84 "id": "00000000-0000-0002-0005-93fc95e0514a",
85 "choices": {"Size": "L"},
86 "variant": {
87 "priceData": {
88 "currency": "ILS",
89 "price": 10.5,
90 "discountedPrice": 9.5,
91 "formatted": {
92 "price": "10.50 ₪",
93 "discountedPrice": "9.50 ₪"
94 }
95 },
96 "visible": true
97 }
98 }
99 ]
100}}