---
title: "Create a new complex"
method: POST
path: "/properties-api/complexes"
tags: ["Complexes"]
---

# Create a new complex

`POST /properties-api/complexes`

Create a new complex and return the ID of the newly created complex

## Request body

- object
  - `title` string, required — The title of the Complex
  - `nickname` string, required — The nickname of the Complex. Useful in searches
  - `propertyIds` string[] — An array that contains Ids for propertyIds that belong to this Complex. Could be an empty array [] (default)
  - `tags` string[] — An array containing Tags for this Complex

## Response `201`

The ID of the newly created complex

- object
  - `id` string

## Other responses

- `400` — Bad Request
- `403` — Unauthorized Request
- `404` — Complex not found

---

[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)