---
title: "Create tag"
method: POST
path: "/tags"
tags: ["Tags"]
---

# Create tag

`POST /tags`

## Request

- Base URL: `https://api.pickfu.com/v1`
- URL: `https://api.pickfu.com/v1/tags`
- Auth: HTTP bearer

Creates a new tag. Tag names must be unique within your team/account (1-100 characters). Returns 409 Conflict if a tag with the same name already exists.

## Request body

- object
  - `name` string, required: Tag name

## Response `201`

Default Response

- object
  - `success` boolean
  - `data` object
    - `id` string: Opaque tag identifier (tag_<32-hex>)
    - `name` string

## Other responses

- `400`: Default Response
- `409`: Default Response

---

[API](https://skmtc.dev/pickfu/apis/pickfu-api.md) · [All operations](https://skmtc.dev/pickfu/apis/pickfu-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pickfu/apis/pickfu-api/revisions/919fc58413ea?raw)