> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atomscale.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Tag Category

> Create a new tag category

Creates a new tag category for your organization. Categories group related tags together. Optionally provide an explicit id.

<ParamField body="name" type="string" required>
  Category name
</ParamField>

<ParamField body="id" type="string">
  Explicit UUID to use for the category. If omitted, the server generates one.
</ParamField>

## Response

Returns the created category.

<ResponseField name="id" type="string">
  Tag category UUID
</ResponseField>

<ResponseField name="name" type="string">
  Category name
</ResponseField>

<ResponseField name="organization_id" type="string">
  ID of the organization the category belongs to
</ResponseField>

<ResponseField name="tag_count" type="integer">
  Number of tags that belong to this category
</ResponseField>

<RequestExample>
  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.atomscale.ai/tags/categories/",
      headers={
          "X-API-KEY": "YOUR_API_KEY",
          "Content-Type": "application/json"
      },
      json={
          "name": "Review Status"
      }
  )
  category = response.json()
  ```

  ```bash cURL theme={null}
  curl -X POST "https://api.atomscale.ai/tags/categories/" \
    -H "X-API-KEY: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Review Status"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "b1a2c3d4-1111-2222-3333-444455556666",
    "name": "Review Status",
    "organization_id": "org_abc123",
    "tag_count": 0
  }
  ```
</ResponseExample>