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

# Create Tag

> Create a tag definition

Create a tag definition for your company. Tag names are normalized to lowercase with spaces replaced by hyphens (for example, `VIP Customer` becomes `vip-customer`).

## Request

<ParamField body="name" type="string" required>
  Tag name. Normalized to lowercase with spaces replaced by hyphens.
</ParamField>

<ParamField body="color" type="string">
  Tag color. One of: `gray`, `red`, `orange`, `amber`, `yellow`, `lime`,
  `green`, `emerald`, `teal`, `cyan`, `sky`, `blue`, `indigo`, `violet`,
  `purple`, `fuchsia`, `pink`, `rose`. Defaults to `gray`.
</ParamField>

```bash theme={null}
curl -X POST "https://api.sequenzy.com/api/v1/tags" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "premium", "color": "blue"}'
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "tag": {
      "id": "tag_abc123",
      "name": "premium",
      "color": "blue",
      "isSystem": false
    }
  }
  ```

  ```json 400 theme={null}
  {
    "error": "Invalid tag color"
  }
  ```

  ```json 401 theme={null}
  {
    "error": "Invalid API key"
  }
  ```

  ```json 409 theme={null}
  {
    "error": "A tag with this name already exists"
  }
  ```

  ```json 500 theme={null}
  {
    "error": "Failed to create tag"
  }
  ```
</ResponseExample>