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

# Create a new alarm category

`POST /v1/alarm-categories`

Create a new alarm category. Requires EPP system access right.

## Request body

- AlarmCategoryCreateUpdate
  - `name` string, required — Alarm category name (cannot be empty).
  - `description` string — Alarm category description.
  - `accessControl` integer[] — User/group IDs allowed to see alarms in this category. Group IDs have the high bit set.

## Response `201`

Alarm category created successfully.

- AlarmCategory
  - `id` integer — Unique alarm category identifier.
  - `name` string — Alarm category name.
  - `description` string — Alarm category description.
  - `accessControl` integer[] — User/group IDs allowed to see alarms in this category. Group IDs have the high bit set.

## 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/revisions/d2e5c5ea6e4c/schema)