---
search:
  tags:
    - administration
    - POST
seo:
  description: >-
    Creates a new task type with the specified configuration.… Reference for the
    POST /administration/task-settings/types endpoint in the Leadtime Public API
    API.
sidebar:
  badge: POST
  label: Create task type
title: Create task type
type: openapi-operation
---
Creates a new task type with the specified configuration. All fields are required.

**Step-by-step process:**
1. Provide a name and icon for the task type
2. Select the base type (Feature or Bug)
3. Add multilingual translations
4. Assign status IDs that can be used with this task type
5. Assign custom field IDs that should appear for this task type
6. Provide a task template as HTML (will be converted to internal format)
7. Specify required field names

**Base types:**
- **Feature**: Value-adding work (typically billable)
- **Bug**: Bug fix or maintenance (typically not billable)

**Task template:**
Provide the template as HTML. It will be automatically converted to the internal IDoc format. The template structures the description field and can include:
- Headings and formatting
- Tables and checklists
- Editor placeholders (hints that disappear after saving)

**Required fields:**
Specify which standard fields must be filled when creating tasks of this type. Common field names: "title", "description", "assignee", "dueDate".

**Note:** After creation, assign this task type to projects to make it available for task creation.

<Operation source="api-reference" id="tasksettingscontroller-createtasktype" />