Most of our content is Publicly accessible. However some content is Private and you will be asked to create an account the first time you try to access this content.
Private content is only available to our existing customers.

POST /Categories

Prev Next

GENERAL INFORMATION

Use this endpoint to create the categories. With categories we mean the categories in a hierarchy that you would expose to your (online) sales channels. Direct link to Swagger documentation:

https://public-api-dev.wair.cloud/swagger/index.html#/Items/post_api_v1_Categories

REQUEST

Authentication

Bearer token, information on page POST /Token

Headers

Name

Description

Example

X-Tenant

Tenant code supplied by Wair

“TENANT”

QueryParameters:

Name

Description

Example

fullLoad

See documentation: Integration core principles

true

Body example:

{
  "categories": [
    {
      "categoryId": "1",
      "code": "M",
      "description": "Men",
      "sortOrder": 1,
      "isActive": true
    },
    {
      "categoryId": "2",
      "code": "MS",
      "description": "Men Shirts",
      "sortOrder": 1,
      "isActive": true,
      "parentCategoryId": "1"
    }
  ]
}

Additional information:

categoryId and code =  Use of "id" and "code" archived

description = description of the category

sortOrder = an integer used to determine the sort order of the categories in a category tree

isActive = whether or not the category is active for the sales channels

parentCategoryId = the id of the category’s parent, if the category has no parent then this field does not need to be sent, or should contain null

RESPONSE

StatusCodes:

200 = OK

401 = Unauthorized, which means an expired/missing/invalid token

400 = Bad request, see body of the response to check which validation errors have occured

500 = System error, see body of the response to check which error has occured or contact integration support

Body Example:

No body in the response.