---
title: "Create a New Tag"
method: POST
path: "/tags"
tags: ["Tags"]
---

# Create a New Tag

`POST /tags`

This endpoint creates a new tag with (optional) member dimensions.
        Once a tag has been created, you cannot change the tag's top-level dimension.

## Headers

- `X-Company-ID` string, required

## Request body

- TagCreateRequest
  - `name` string, required
  - `member_ids` integer[], required
  - `top_level_dimension_name` string, required

## Response `200`

- TagCreateResponse
  - `id` integer, required
  - `is_recalculating` boolean, required
  - `members` object[], required
  - `name` string, required
  - `top_level_dimension_name` string, required

---

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