Wix API 2024 – How to increase or decrease inventory using Postman

Table of Contents

In Wix API, you can increase or decrease inventory by using Postman. Instead of wasting a lot of time manually changing each variant’s inventory, you can do it quickly by using Wix API.

Now, let’s dive into this subject a little deeper to know how to increase or decrease inventory using Postman in Wix API. 

If this is the first time you make a call in the Postman, you must generate API credentials from the Wix Developers website.

Step 1: Generate API credentials from the Wix Developers’ Website.

Follow the process in Wix API: How to get an access token and refresh the access token? To know how to access Wix API. 

  • After creating an app, remember the access token and the refresh token to send requests in the Postman. 

Step 2: Refresh the access token using Postman. 

Wix’s access token is only valid for 5 minutes, so you need to use the refresh token to request a new access token.

Flowing the steps below for refreshing the access token. 

  • Log in to your Postman and create a new workspace.
  • Create a new POST with this URL:
https://www.wix.com/oauth/access
refresh the access token in Wix API
  • In the body section, enter the code.

Payload

{
    "grant_type": "refresh_token",
    "client_id": <APP_ID>,
    "client_secret": <APP_SECRET>,
    "refresh_token": <REFRESH_TOKEN>
}
refresh the access token in Wix API

Body Params:

NAMETYPEDESCRIPTION
grant_typestringValue must be set to “refresh_token”
client_idstringThe App ID as defined in the Wix Developers Center
client_secretstringThe Secret Key for your app as defined in your Wix Developers Center
refresh_tokenstringThe refresh token issued with the access token
  • Then click SEND

Response:

The Postman will return the new access token and the refresh token in order to request a new access token.

refresh the access token in Wix API

Step 3: Get the Product ID and the Variant ID

Product ID

The next call includes the product ID, so you need to get that parameter first. 

  • From the Wix dashboard
  • Go to “Store products”
  • and choose “Products”
  • Click on a product that you want to see
  • Copy the product ID in the URL.
get the product ID in the Wix dashboard

Product ID = df19c1f7-07d8-a265-42f8-e8dfa824cc6e

Variant ID

Besides, Beehexa will show you the product variant information and the inventory of that variant so you can see the inventory change in step 4.

  • Scroll down to the “Manage variants” section
get the product ID in the Wix dashboard

As you can see, the variant we will get the ID is Small Black, with 2 product variants in stock.

Variants are combinations of product options.

Before increasing the variant’s inventory, you need to get the variant_ID. Because the next call includes that parameter. The variant ID doesn’t show in the dashboard or Wix store. To get the variant ID, you need to use API. 

Now we will get the Variant ID.

  • Log in to your Postman and create a new workspace.
  • Create a new POST with this URL:
https://www.wixapis.com/stores/v1/products/{id}/variants/query

{id} = Product ID.

-HEADER:  ‘Authorization: <ACCESS TOKEN>’

In this call, you must ensure that you are granted permission to read the products.

get the variant ID in Wix

In the body, enter the code.

Payload:

{
    "choices": {
        "Black Shoes": "Black"
    },
    "includeMerchantSpecificData": true
}

“Black Shoes”: “Black” –> Option-choice key-value pairs

get the variant ID in Wix API using Postman

Click send

Response: 

As you can see, the Postman returned the variant information like this.

get the variant ID in Wix API using Postman

Copy the variant ID to use in the next call. 

Variant ID = 972d06ae-6676-46c6-b3d7-be5af8fc4a9d

Step 4: Increase inventory using Postman

Now, we are ready to increase inventory.

  • Log in to your Postman and create a new workspace.
  • Create a new POST with this URL:
https://www.wixapis.com/stores/v2/inventoryItems/increment
Wix API - How to increase or decrease inventory using Postman

-HEADER:  ‘Authorization: <ACCESS TOKEN>’

In the body section, enter the code.

Payload:

{
    "incrementData": [{
        "productId": "<PRODUCT_ID>",
        "variantId": “<VARIANT_ID>”,
        "incrementBy": 10
    }]
}
Wix API - How to increase or decrease inventory using Postman

Then click SEND

Response: 

The Postman returned the empty array. It means the quantity of the variant has been increased. 

Wix API - How to increase or decrease inventory using Postman

Step 5: Verify the result

After increasing the inventory of the product variant, you can see the result in the Wix dashboard.

  • From the Wix dashboard
  • Go to the “Store products”
  • and Choose “Products”
  • Click on the product
  • Scroll down to the “Manage variants” section.

As you can see, the quantity of Small Black has increased from 2 to 12.

Wix API - How to increase or decrease inventory using Postman

Step 6: Decrease inventory using Postman

To decrease inventory, you can do the same with step 4. Remember to change the URL and payload:

URL:

https://www.wixapis.com/stores/v2/inventoryItems/decrement

Payload:

{
    "decrementData": [{
        "productId": "<PRODUCT_ID>",
        "variantId": "<VARIANT_ID>",
        "decrementBy": 10
    }]
}

The above steps are to increase or decrease inventory using Postman with Wix API. The next article will explore Wix rest API and multiple ways to make API calls. 

If you have any questions, let us know in the comment below or refer to our Wix API documentation.

These steps will be shown visually in the infographic below.

Wix API - How to increase or decrease inventory using Postman

Or you can watch this video for more overview.

Hopefully, you can do it!