---
title: "Create a new database field (property)"
method: POST
path: "/public/api/v1/databases/{databaseId}/fields"
tags: ["Fields"]
---

# Create a new database field (property)

`POST /public/api/v1/databases/{databaseId}/fields`

## Path parameters

- `databaseId` string, required

## Request body

- union
  - FieldCreateRequest
    - `requestId` string, required — Should be any unique value, e.g. UUID, current timestamp etc
    - `title` string, required
    - `type` 'id' | 'text' | 'number' | 'percent' | 'checkbox' | 'date' | 'duration' | 'currency' | 'singleSelect' | 'multiSelect' | 'linkToDatabase' | 'formula', required
    - `readerIds` string[]
  - SingleSelectFieldCreateRequest
    - `requestId` string, required — Should be any unique value, e.g. UUID, current timestamp etc
    - `title` string, required
    - `type` 'id' | 'text' | 'number' | 'percent' | 'checkbox' | 'date' | 'duration' | 'currency' | 'singleSelect' | 'multiSelect' | 'linkToDatabase' | 'formula', required
    - `readerIds` string[]
    - `allowedEnumValues` OptionWithColor[], required
      - `id` string
      - `name` string, required
      - `color` 'Brown' | 'Red' | 'Purple' | 'Indigo' | 'DarkBlue' | 'Blue' | 'Turquoise' | 'DarkCyan' | 'Green' | 'YellowGreen' | 'Yellow' | 'Orange' | 'Gray' | 'DarkRed'
  - MultiSelectFieldCreateRequest
    - `requestId` string, required — Should be any unique value, e.g. UUID, current timestamp etc
    - `title` string, required
    - `type` 'id' | 'text' | 'number' | 'percent' | 'checkbox' | 'date' | 'duration' | 'currency' | 'singleSelect' | 'multiSelect' | 'linkToDatabase' | 'formula', required
    - `readerIds` string[]
    - `allowedEnumValues` OptionWithColor[], required
      - `id` string
      - `name` string, required
      - `color` 'Brown' | 'Red' | 'Purple' | 'Indigo' | 'DarkBlue' | 'Blue' | 'Turquoise' | 'DarkCyan' | 'Green' | 'YellowGreen' | 'Yellow' | 'Orange' | 'Gray' | 'DarkRed'
  - LinkToDatabaseFieldCreateRequest
    - `requestId` string, required — Should be any unique value, e.g. UUID, current timestamp etc
    - `title` string, required
    - `type` 'id' | 'text' | 'number' | 'percent' | 'checkbox' | 'date' | 'duration' | 'currency' | 'singleSelect' | 'multiSelect' | 'linkToDatabase' | 'formula', required
    - `readerIds` string[]
    - `databaseId` string, required
    - `allowMultipleEntries` boolean, required
    - `mirrorFields` MirrorFieldCreate[]
      - `title` string, required
      - `fieldId` string, required
  - FormulaFieldCreateRequest
    - `requestId` string, required — Should be any unique value, e.g. UUID, current timestamp etc
    - `title` string, required
    - `type` 'id' | 'text' | 'number' | 'percent' | 'checkbox' | 'date' | 'duration' | 'currency' | 'singleSelect' | 'multiSelect' | 'linkToDatabase' | 'formula', required
    - `readerIds` string[]
    - `formula` string, required
    - `format` 'number' | 'currency' | 'percent' | 'hours' | 'days' | 'date', required

## Response `200`

OK

- union
  - FieldResponse
    - `isMirror` boolean, required
    - `id` string, required
    - `title` string, required
    - `type` 'id' | 'text' | 'number' | 'percent' | 'checkbox' | 'date' | 'duration' | 'currency' | 'singleSelect' | 'multiSelect' | 'linkToDatabase' | 'formula', required
    - `readerIds` string[]
  - SingleSelectFieldResponse
    - `isMirror` boolean, required
    - `id` string, required
    - `title` string, required
    - `type` 'id' | 'text' | 'number' | 'percent' | 'checkbox' | 'date' | 'duration' | 'currency' | 'singleSelect' | 'multiSelect' | 'linkToDatabase' | 'formula', required
    - `readerIds` string[]
    - `allowedEnumValues` OptionWithColor[], required
      - `id` string
      - `name` string, required
      - `color` 'Brown' | 'Red' | 'Purple' | 'Indigo' | 'DarkBlue' | 'Blue' | 'Turquoise' | 'DarkCyan' | 'Green' | 'YellowGreen' | 'Yellow' | 'Orange' | 'Gray' | 'DarkRed'
  - MultiSelectFieldResponse
    - `isMirror` boolean, required
    - `id` string, required
    - `title` string, required
    - `type` 'id' | 'text' | 'number' | 'percent' | 'checkbox' | 'date' | 'duration' | 'currency' | 'singleSelect' | 'multiSelect' | 'linkToDatabase' | 'formula', required
    - `readerIds` string[]
    - `allowedEnumValues` OptionWithColor[], required
      - `id` string
      - `name` string, required
      - `color` 'Brown' | 'Red' | 'Purple' | 'Indigo' | 'DarkBlue' | 'Blue' | 'Turquoise' | 'DarkCyan' | 'Green' | 'YellowGreen' | 'Yellow' | 'Orange' | 'Gray' | 'DarkRed'
  - LinkToDatabaseFieldResponse
    - `isMirror` boolean, required
    - `id` string, required
    - `title` string, required
    - `type` 'id' | 'text' | 'number' | 'percent' | 'checkbox' | 'date' | 'duration' | 'currency' | 'singleSelect' | 'multiSelect' | 'linkToDatabase' | 'formula', required
    - `readerIds` string[]
    - `databaseId` string, required
    - `allowMultipleEntries` boolean, required
    - `mirrorFields` MirrorField[]
      - `id` string, required
      - `title` string, required
      - `fieldId` string, required
  - FormulaFieldResponse
    - `isMirror` boolean, required
    - `id` string, required
    - `title` string, required
    - `type` 'id' | 'text' | 'number' | 'percent' | 'checkbox' | 'date' | 'duration' | 'currency' | 'singleSelect' | 'multiSelect' | 'linkToDatabase' | 'formula', required
    - `readerIds` string[]
    - `formula` string, required
    - `format` 'number' | 'currency' | 'percent' | 'hours' | 'days' | 'date', required

---

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