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

**Step-by-step process:**
1. Provide a default name and description (used as fallback when no translation exists)
2. Select the field type (Text, TextArea, Number, Date, Checkbox, Select, or MultiSelect)
3. For Select or MultiSelect types, provide select options with default values
4. Add multilingual translations for field name, description, and select options
5. The field will be available to assign to task types

**Field types:**
- **Text**: Short text entries (e.g., "Responsible reviewer")
- **TextArea**: Longer text entries (e.g., "Audit result")
- **Number**: Numeric values
- **Date**: Date values
- **Checkbox**: Yes/No information
- **Select**: Single selection from predefined options (requires selectOptions)
- **MultiSelect**: Multiple selections from predefined options (requires selectOptions)

**Multilingual support:**
Provide translations for field name, description, and select options. Leadtime automatically displays the correct text based on the user language.

**Note:** After creation, assign this custom field to specific task types to make it appear in task forms.

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