---
title: "Create a new object category"
method: POST
path: "/v1/object-categories"
tags: ["Object Categories"]
---

# Create a new object category

`POST /v1/object-categories`

Create a new object category. Requires MANAGE_OBJECT_CATEGORIES system access right.

## Request body

- ObjectCategoryCreateUpdate
  - `name` string, required — Object category name (cannot be empty).
  - `icon` string, uuid — UUID of the icon image from the image library.
  - `mapImage` string, uuid — UUID of the map image from the image library.

## Response `201`

Object category created successfully.

- ObjectCategory
  - `id` integer — Unique object category identifier.
  - `name` string — Object category name.
  - `icon` string, uuid — UUID of the icon image from the image library.
  - `mapImage` string, uuid — UUID of the map image from the image library.

## Other responses

- `400` — Invalid request (missing or empty name).
- `401` — Unauthorized.
- `403` — Access denied.
- `500` — Internal server error.

---

[API](https://skmtc.net/netxms/apis/netxms-api.md) · [All operations](https://skmtc.net/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netxms/netxms-api/versions/14d93e5115dd/schema)