> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getjusto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Crear categoría

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



## OpenAPI

````yaml post /ecommerce/categories
openapi: 3.1.0
info:
  title: Justo API
  version: 3.0.0
servers:
  - url: https://api.service.getjusto.com/v3
    description: Production server
security: []
paths:
  /ecommerce/categories:
    post:
      summary: Create category
      description: >-
        Crea una categoría en la marca. Para que aparezca en la tienda debe
        tener productos disponibles.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/apiCategoryCreateInput'
      responses:
        '200':
          description: The OpenAPI spec
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    $ref: '#/components/schemas/apiCategory'
        '400':
          description: Errors
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: 'false'
                  error:
                    type: object
                    properties:
                      error:
                        type: string
                        example: error
                      message:
                        type: string
                        example: The request has an error
components:
  schemas:
    apiCategoryCreateInput:
      type: object
      description: Datos de la categoría nueva. Se agrega al final del orden de la marca.
      required:
        - name
      additionalProperties: false
      properties:
        name:
          type: string
          minLength: 1
          description: Nombre visible de la categoría.
        externalId:
          type: string
          description: ID externo único en la marca, para integraciones.
        parentId:
          type: string
          description: >-
            ID Justo o ID externo de la categoría padre, para crear una
            subcategoría.
      example:
        name: Postres
    apiCategory:
      type: object
      description: Categoría de productos.
      properties:
        categoryId:
          type: string
          description: ID Justo de la categoría.
        importId:
          type: string
          description: ID de importación de la categoría.
        name:
          type: string
          description: Nombre de la categoría.
        index:
          type: number
          description: Posición de ordenamiento.
        externalId:
          type: string
          description: ID externo configurado por la marca.
        metadata:
          type: object
          description: Metadata del item escrita por API v3.
          additionalProperties: true

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.