---
title: "Create a new call tag"
method: POST
path: "/tags"
tags: ["tags"]
---

# Create a new call tag

`POST /tags`

Creates a new tag for your team. Tags are team-wide labels used to categorize calls. Each tag has a `name`, an optional `description`, and a `color` chosen from a predefined palette (18 hex colors). Tag names should be unique within the team. Once created, tags can be attached to calls for filtering and reporting.

**Permission:** `IVRs Write` required.

**Monitoring:** Not needed. Tag creation works regardless of the Monitoring flag.

## Request body

- object
  - `name` string — The name of the tag
  - `color` 'ff6b6b' | 'F06292' | 'BA68C8' | '9575CD' | '7986CB' | '64B5F6' | '4FC3F7' | '4DD0E1' | '4DB6AC' | '81C784' | 'AED581' | 'DCE775' | 'FFD54F' | 'FFB74D' | 'FF8A65' | 'A1887F' | 'E0E0E0' | '90A4AE'
  - `description` string — The description of the tag

## Response `200`

Successful operation — tag created.

## Other responses

- `401` — Unauthorized — invalid or missing API token, or missing `IVRs Write` permission.
- `500` — Internal server error.

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)