# Create a new category

Creates a new category record.

Endpoint: POST /v1/api/category
Version: 1.2.4
Security: X-Api-Key

## Request fields (application/json):

  - `name` (string, required)
    Name of the category.
    Example: "Beverages"

  - `description` (string, required)
    Description of the category.
    Example: "Beverages are drinks that are not alcoholic."

  - `image` (string)
    Image of the category.
    Example: "https://example.com/image.jpg"

  - `externalId` (string)
    External ID of the category.
    Example: "1234567890"

  - `parentId` (string)
    Parent ID of the category.
    Example: "o1p2q3r4s5t6u7v8w9x0y1z2"

  - `menuOrder` (number)
    Menu order of the category.
    Example: 1

  - `source` (string)
    Source of the category.
    Example: "manual"

## Response 201 fields (application/json):

  - `id` (string)
    Unique identifier for the Categories.
    Example: "o1p2q3r4s5t6u7v8w9x0y1z2"

  - `createdAt` (string)
    Timestamp when the Categories was created.
    Example: "2025-12-07T19:31:48.436+00:00"

  - `updatedAt` (string)
    Timestamp when the Categories was last updated.
    Example: "2025-12-07T19:35:48.436+00:00"

  - `companyId` (string)
    Company ID associated with the Categories.
    Example: "o1p2q3r4s5t6u7v8w9x0y1z2"

  - `name` (string)
    Name of the category.
    Example: "Beverages"

  - `description` (string)
    Description of the category.
    Example: "Beverages are drinks that are not alcoholic."

  - `image` (string)
    Image of the category.
    Example: "https://example.com/image.jpg"

  - `externalId` (string)
    External ID of the category.
    Example: "1234567890"

  - `parentId` (string)
    Parent ID of the category.
    Example: "o1p2q3r4s5t6u7v8w9x0y1z2"

  - `menuOrder` (number)
    Menu order of the category.
    Example: 1

  - `source` (string)
    Source of the category.
    Example: "manual"

## Response 400 fields (application/json):

  - `statusCode` (number, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message describing what went wrong
    Example: "Validation failed: Field `schemaField` is required."

  - `error` (string, required)
    Error type/name
    Enum: "Bad Request", "Unauthorized", "Forbidden", "Not Found", "Conflict", "Unprocessable Entity", "Internal Server Error"