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

# Create tag

`POST /tags`

<small>Requires an API token with the **Tag Manager** role.</small>

Creates a new tag in your account.

Tags are simple labels that can be assigned to [documents](/#documents) and [templates](/#templates).

## Request body

- StoreTagRequest
  - `name` string, required — The name of the tag.
  - `color` string, required — The color of the tag as a hex string.

## Response `201`

`TagResource`

- object
  - `data` TagResource, required
    - `uuid` string, required
    - `name` string, nullable, required
    - `color` string, required — Hex color code for the color that the tag has been assigned

## Other responses

- `401` — Unauthenticated
- `403` — Authorization error
- `422` — Validation error

---

[API](https://skmtc.dev/fynk/apis/fynk-api-reference.md) · [All operations](https://skmtc.dev/fynk/apis/fynk-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fynk/fynk-api-reference/revisions/9657a6757f59/schema)
