Create a new tag

Creates a new tag of the specified type. If a tag with the same name already exists (case-insensitive), returns the existing tag instead of creating a duplicate.

How tag creation works:

• Provide a tag name (required)
• The system checks for existing tags with the same name (case-insensitive)
• If a tag exists, it is returned (no duplicate created)
• If no tag exists, a new one is created
• Tag color can be set later using the save endpoint

Tag Colors: Tags use predefined color codes, not hex values. Available colors: default, red, yellow, green, blue, purple, fuchsia, pink, magenta.

Use cases:

• Create standard tags for recurring topics (e.g., “Billing”, “Support”, “Onboarding”)
• Organize tasks by process or workflow stage
• Enable cross-project filtering and analysis
• Set up cascading tags in project components for automatic inheritance

Best practices:

• Use consistent naming to avoid duplicates (e.g., do not use both “Billing” and “Invoice”)
• Create standard tags for recurring topics to keep your team organized
• Use colors strategically for visual organization (set via save endpoint)

Permission requirements:

• Task tags: Requires Tasks.createTags permission
• Project tags: Must be an employee (not organization member)
• Project component tags: Requires ProjectComponentsLibrary.edit OR Projects.manageComponents permission

curl -X POST "https://leadtime.app/api/public/tags/task/create" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "urgent"
}'

const response = await fetch("https://leadtime.app/api/public/tags/task/create", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "name": "urgent"
})
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/tags/task/create",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "name": "urgent"
},
)

{
  "color": "blue",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "isDeleted": false,
  "name": "urgent"
}