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

# Create a tag

`POST /tags`

## Request

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

Create a new tag. The tag name must be unique.
    Tag names are case-sensitive, that is `Marketing` and `marketing` are two different tags.


The response returns an auto-generated ID assigned to this tag.
To assign this tag to a resource, send the tag ID in the `tag_ids` list when creating or updating a resource.

## Headers

- `x-monite-version` string, required
- `x-monite-entity-id` string, required

## Request body

- object
  - `category` 'document_type' | 'department' | 'project' | 'cost_center' | 'vendor_type' | 'payment_method' | 'approval_status'
  - `description` string: The tag description.
  - `name` string, required: The tag name. Must be unique.

## Response `201`

Successful Response

- TagReadSchema: Represents a user-defined tag that can be assigned to resources to filter them.
  - `id` string, uuid, required: A unique ID of this tag.
  - `created_at` string, date-time, required: Date and time when the tag was created. Timestamps follow the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) standard.
  - `updated_at` string, date-time, required: Date and time when the tag was last updated. Timestamps follow the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) standard.
  - `category` 'document_type' | 'department' | 'project' | 'cost_center' | 'vendor_type' | 'payment_method' | 'approval_status'
  - `created_by_entity_user_id` string, uuid: ID of the user who created the tag.
  - `description` string: The tag description.
  - `name` string, required: The tag name.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `406`: Not Acceptable
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/monite/apis/monite-3.md) - [All operations](https://skmtc.dev/monite/apis/monite-3/llms.txt) - [OpenAPI document](https://skmtc.dev/monite/apis/monite-3/revisions/c13be6f83ce9?raw)