Documentation Index

Fetch the complete documentation index at: https://docs.wair.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.