---
title: "Create custom fields on a workspace"
method: POST
path: "/v1/workspaces/{workspaceId}/custom-fields"
tags: ["Custom fields"]
---

# Create custom fields on a workspace

`POST /v1/workspaces/{workspaceId}/custom-fields`

## Path parameters

- `workspaceId` string, required — Represents workspace identifier across the system.

## Request body

- CustomFieldRequestV1
  - `allowedValues` string[] — Represents a list of custom field's allowed values.
  - `description` string — Represents custom field description.
  - `entityType` 'TIMEENTRY' | 'USER' — Represents custom field entity type
  - `name` string, required — Represents custom field name.
  - `onlyAdminCanEdit` boolean — Flag to set whether custom field is modifiable only by admin users.
  - `placeholder` string — Represents custom field placeholder value.
  - `status` 'INACTIVE' | 'VISIBLE' | 'INVISIBLE' — Represents custom field status
  - `type` 'TXT' | 'NUMBER' | 'DROPDOWN_SINGLE' | 'DROPDOWN_MULTIPLE' | 'CHECKBOX' | 'LINK', required — Represents custom field type.
  - `workspaceDefaultValue` object — Represents a custom field's default value in the workspace.<li>if type = NUMBER, then value must be a number</li><li>if type = DROPDOWN_MULTIPLE, value must be a list</li><li>if type = CHECKBOX, value must be true/false</li><li>otherwise any string</li>

## Response `201`

Created

---

[API](https://skmtc.dev/clockify/apis/clockify-api.md) · [All operations](https://skmtc.dev/clockify/apis/clockify-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clockify/clockify-api/revisions/a5b636acbcd8/schema)