---
title: "Create a tag"
method: POST
path: "/tags"
tags: ["public_tags", "public", "Tags"]
---

# Create a tag

`POST /tags`

Create a tag

## Request body

- TagCreateRequest
  - `name` string, required
  - `color` string, required
  - `workspaceId` string, uuid, required

## Response `200`

Successful operation

- TagResponse — Provides details of a single tag.
  - `tagId` string, uuid, required
  - `name` string, required
  - `color` string, required — A hexadecimal color value
  - `workspaceId` string, uuid, required

## Other responses

- `400` — Invalid data
- `403` — Not allowed
- `409` — Tag with same name already exists

## Changes

> 31 revisions in range; 1 could not be searched.

- **2025-02-20** `219abe72845a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/airbytehq/apis/airbyte-api/changes/tags/post.md)

---

[API](https://skmtc.dev/airbytehq/apis/airbyte-api.md) · [All operations](https://skmtc.dev/airbytehq/apis/airbyte-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/airbytehq/airbyte-api/revisions/1ab9ff46c57a/schema)