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

# Create Tag

`POST /tags`

Create a new property tag. Optionally pre-attach properties via `property_ids` and / or room types via `room_type_ids`. The name must be unique within the operator's account (soft-deleted same-name tags are restored). Color is auto-assigned from the Hostex palette unless one of the allowed hex strings is supplied. Operators are capped at 500 property tags.

## Request body

- object
  - `name` string, required — Tag display name. Max 15 characters. Must be unique within the operator's account.
  - `color` '#FD587B' | '#1BBFA4' | '#FFA410' | '#F3D432' | '#2CBCFD' | '#7175FA' | '#EF7EDE' — Hex color string. Auto-assigned from the palette when omitted.
  - `property_ids` integer[] — Optional list of property ids to attach to the new tag.
  - `room_type_ids` integer[] — Optional list of room type ids to attach to the new tag.

## 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
    - `tag` PropertyTag, required
      - `id` integer, required
      - `name` string, required
      - `color` string, required
      - `property_ids` integer[], required
      - `room_type_ids` integer[], required

---

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