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

# Create tag

`POST /tags`

Creates a new tag for the given entity type.

## Request body

- TagInput
  - `name` string, required — Tag name
  - `type` 'leads' | 'deals' | 'clients' | 'contacts' | 'projects' | 'project_tasks' | 'invoices' | 'quotations' | 'schedules' | 'fs_jobs' | 'purchase_orders' | 'vendors' | 'bills', required — Entity type the tag applies to
  - `color` string, required — Tag color (hex)
  - `icon` string, nullable — Tag icon

## Response `200`

OK

- Tag
  - `id` string, required — Tag ID
  - `name` string, required — Tag name
  - `color` string, required — Tag color (hex)
  - `icon` string, nullable — Tag icon
  - `type` 'leads' | 'deals' | 'clients' | 'contacts' | 'projects' | 'project_tasks' | 'invoices' | 'quotations' | 'schedules' | 'fs_jobs' | 'purchase_orders' | 'vendors' | 'bills', required — Entity type the tag applies to

## Other responses

- `400` — Validation error or bad request
- `401` — Missing or invalid API key
- `403` — Insufficient permission
- `404` — Resource not found
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/heffl/apis/heffl-api-v2-beta.md) · [All operations](https://skmtc.dev/heffl/apis/heffl-api-v2-beta/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/heffl/heffl-api-v2-beta/revisions/27006cfef4d8/schema)