---
title: "Create category"
method: POST
path: "/ecommerce/categories"
---

# Create category

`POST /ecommerce/categories`

## Request

- Base URL: `https://api.service.getjusto.com/v3`
- URL: `https://api.service.getjusto.com/v3/ecommerce/categories`
- Auth: none declared

Crea una categoría en la marca. Para que aparezca en la tienda debe tener productos disponibles.

## Request body

- ApiCategoryCreateInput: Datos de la categoría nueva. Se agrega al final del orden de la marca.
  - `name` string, required: Nombre visible de la categoría.
  - `externalId` string: ID externo único en la marca, para integraciones.
  - `parentId` string: ID Justo o ID externo de la categoría padre, para crear una subcategoría.

## Response `200`

The OpenAPI spec

- object
  - `success` boolean
  - `data` ApiCategory: Categoría de productos.
    - `categoryId` string: ID Justo de la categoría.
    - `importId` string: ID de importación de la categoría.
    - `name` string: Nombre de la categoría.
    - `index` number: Posición de ordenamiento.
    - `externalId` string: ID externo configurado por la marca.
    - `metadata` object: Metadata del item escrita por API v3.

## Other responses

- `400`: Errors

## Changes

- **2026-10-31** `4ad06bd631ce`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getjusto/apis/justo-api/changes/ecommerce/categories/post.md)

---

[API](https://skmtc.dev/getjusto/apis/justo-api.md) - [All operations](https://skmtc.dev/getjusto/apis/justo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getjusto/apis/justo-api/revisions/c810bd8246fd?raw)