--- search: tags: - tags - POST seo: description: >- Creates a new tag of the specified type. If a tag with the same name… Reference for the POST /tags/{type}/create endpoint in the Leadtime Public API API. sidebar: badge: POST label: Create a new tag title: Create a new tag type: openapi-operation --- 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 - Label documentation pages with a shared workspace-level documentation taxonomy **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 - Project documentation tags: Requires Projects.manageDocumentation permission