---
title: "Create Group"
method: POST
path: "/groups"
tags: ["Property"]
---

# Create Group

`POST /groups`

Create a new property group. Optionally pre-attach properties at creation time via `property_ids`. The group name must be unique within the operator's account.

## Request body

- object
  - `name` string, required — Group display name. Max 50 characters. Must be unique within the operator's account.
  - `property_ids` integer[] — Optional list of property ids to attach to the new group. Each id must belong to the operator.

## Response `200`

- object
  - `request_id` string, required — Unique identifier for the request.
  - `error_code` integer, required — Numeric error code representing the status of the response. A value of `200` indicates success. <br> See the [Error Codes](/reference/error-manual#error-codes) section for more information.
  - `error_msg` string, required — Message detailing the status of the response.
  - `data` object, required
    - `group` object, required
      - `id` integer, required
      - `name` string, required
      - `property_ids` integer[], required

---

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