---
title: "/customfields"
method: POST
path: "/v1/customfields"
tags: ["Custom Fields"]
---

# /customfields

`POST /v1/customfields`

Create a custom field (maximum total allowed per workspace: `100`)

**Body**

- name - the name of the custom field
    
- description - the description of the custom field
    
- type - the type of the custom field
    
- values - the values of a `single-select` or `multi-select` custom field

## Request body

- object
  - `name` string — The name of the custom field
  - `description` string — The description of the custom field
  - `type` 'single-select' | 'multi-select' | 'plain-text' | 'date' — The type of custom field
  - `values` string[] — The values of the custom field

## Response `200`

Custom field created successfully

- object
  - `id` string
  - `name` string
  - `description` string
  - `type` 'single-select' | 'multi-select' | 'plain-text' | 'date' — The type of custom field
  - `values` object[], nullable
    - `id` string
    - `name` string

---

[API](https://skmtc.net/air/apis/air-api.md) · [All operations](https://skmtc.net/air/apis/air-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/air/air-api/versions/2bd9c9fa2a0c/schema)