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

# Create Tag

`POST /tags`

Create a new tag within a project

## Request body

- object
  - `name` string, required
  - `color` 'gray' | 'red' | 'orange' | 'yellow' | 'lime' | 'green' | 'cyan' | 'blue' | 'purple' | 'fuchsia' | 'pink' | 'emerald' | 'amber' | 'violet' | 'indigo' | 'teal' | 'sky' | 'rose' | 'slate' | 'zinc' | 'neutral' | 'stone'
  - `group` string, nullable — Optional tag group. Tags sharing a group are colored as a unit, so a grouped tag inherits the group's color and the `color` field is ignored.

## Response `201`

Tag created successfully

- object — Tag created successfully
  - `id` string, required

## Other responses

- `409` — Response for status 409

---

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