Skip to content

Create Category

Request

Crea una nueva categoría con sus subcategorías

Security
api-key
Bodyapplication/jsonrequired
categoryobjectrequired
curl -i -X POST \
  https://mercately.shop/api/v1/categories \
  -H 'Content-Type: application/json' \
  -H 'api-key: YOUR_API_KEY_HERE' \
  -d '{
    "category": {
      "name": "Electrónica",
      "description": "Productos electrónicos y dispositivos tecnológicos",
      "order": 1,
      "subcategories_attributes": [
        {
          "name": "Smartphones",
          "description": "Teléfonos inteligentes y accesorios",
          "order": 1
        },
        {
          "name": "Laptops",
          "description": "Computadoras portátiles",
          "order": 2
        }
      ]
    }
  }'

Responses

Category created successfully

Bodyapplication/json
web_idstring

Identificador único de la categoría

Example:"I7ROmS7Jui"
namestring

Nombre de la categoría

Example:"Electrónica"
descriptionstring

Descripción de la categoría

Example:"Productos electrónicos y dispositivos tecnológicos"
products_countinteger

Número de productos activos en la categoría

Example:0
orderinteger

Orden de visualización de la categoría

Example:1
subcategoriesArray of objects

Lista de subcategorías

Response
{
  "web_id": "I7ROmS7Jui",
  "name": "Electrónica",
  "description": "Productos electrónicos y dispositivos tecnológicos",
  "products_count": 0,
  "order": 1,
  "subcategories": [
    { … },
    { … }
  ]
}
Copyleft © Mercately Inc.