---
title: "Add a new Tag"
method: POST
path: "/tag"
tags: ["tags"]
---

# Add a new Tag

`POST /tag`

Add a new Tag

## Response `201`

successful operation

- Tag[]
  - `tagId` integer — The Tag ID
  - `tag` string — The Tag Name
  - `isSystem` integer — Flag, whether the tag is a system tag
  - `isRequired` integer — Flag, whether the tag requires additional values
  - `options` string[] — An array of options assigned to this Tag
  - `layouts` string[] — An array of layoutID and values pairs with this Tag
  - `playlists` string[] — An array of playlistIDs and values with this Tag
  - `campaigns` string[] — An array of campaignIDs and values with this Tag
  - `medias` string[] — An array of mediaIds and values with this Tag
  - `displayGroups` string[] — An array of displayGroupIds and values with this Tag
  - `value` string — The Tag Value

## Changes

- **2020-02-17** `8e1275395104` — 2 breaking
  - removed the request body
  - removed the media type `application/json` for the response with the status `201`

[Change history](https://skmtc.dev/xibosignage/apis/xibo-api/changes/tag/post.md)

---

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