---
title: "Create a new group"
method: POST
path: "/properties-api/groups/group"
tags: ["Groups [Pilot]"]
---

# Create a new group

`POST /properties-api/groups/group`

Create a combo property or property variant (duplicates) to organize related listings with a designated primary listing. The term group refers to both types: COMBO (combo properties) and DUPLICATES (property variants).

Check out our [Help Center](https://help.guesty.com/hc/en-gb/articles/33014581967901-Pilot-Managing-combo-properties-and-property-variants) to learn more about these property types.

## Request body

- object
  - `type` 'COMBO' | 'DUPLICATES', required — Type of the group
  - `primary` string, required — Primary listing ID
  - `members` string[], required — Array of listing IDs to be added to the group

## Response `201`

Group was successfully created

- object
  - `groupId` string
  - `type` 'COMBO' | 'DUPLICATES'
  - `primary` string
  - `members` string[]

## Other responses

- `400` — Invalid request data or business rule violation
- `403` — Insufficient permissions

---

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