[POST] Categories

Create Category

This operation allows you to create a new category in the catalog.

It follows REST architecture principles and complies with the OData v4.01 standard.

‍

[POST] Categories Endpoint

https://api2.saleslayer.com/rest/Catalog/Categories

Making a request

Use the HTTP method: POST.
Include the API key in the request headers for authentication.
The body must be sent in JSON format.
You must include attributes using their identifiers (not database names)
The cat_ref field is mandatory.

Request body example:

{
  "cat_ref": "CAT001",
  "cat_title": "Men's Footwear",
  "cat_stat": "D",
  "cat_description": "Category for men's footwear products",
  "cat_image": "cat_men.png",
  "cat_parent_id": 2
}

‍📝You can include multilingual and media attributes if they have been previously defined in your account configuration.

‍

Response

🟢 201 Created

If the category was successfully created.

Example of response headers:

content-length: 0 
 date: Tue,27 May 2025 23:06:09 GMT 
 location: https://api2.saleslayer.com/rest/Catalog/Categories(3)

‍📝 Please note that the response returns the cat_id, which is useful for future reference.
‍

🔴 400 Bad Request

There was an error in the submitted data (invalid format, missing or incorrect fields).

Response Body Example

"Attribute cat_ref is mandatory"

"Missing file name(s):Cat_men2.png."

‍

Limitations

Only one category can be created per request.
Bulk category creation is not supported.
Only one cat_parent_id can be assigned.
Images and files must already exist in the media library.

‍

Multi-language fields support

You can include multilingual values for attributes that are configured to support multiple languages.

Making a request

Use HTTP method: POST.
Include your API key in the request headers.
Specify preferred language using the Accept-Language header.
The body must be sent in JSON format.
The field cat_ref is mandatory.
Multilingual fields must be sent as JSON objects with each supported language as a key.

Multilingual body example:

{
  "cat_ref": "CAT002",
  "cat_title": {
    "es": "Zapatillas",
    "en": "Sneakers"
  },
  "cat_stat": "V",
  "cat_description": {
    "es": "Calzado deportivo y urbano",
    "en": "Urban and sport footwear"
  },
  "cat_image": "sneakers_banner.jpg"
}

📝Make sure the attribute supports multiple languages and that the languages are enabled in your account.

Multilingual field conditions

You can send multilingual values for fields only if:

The field is defined as multilingual in the attribute set.
The languages used are supported by your account.

Common errors:

Unsupported language → 400 - Invalid language code
Non-multilingual field → 400 - Attribute does not support multi-language

‍