---
title: "Create a Field"
method: POST
path: "/1.0/fields"
tags: ["Fields"]
---

# Create a Field

`POST /1.0/fields`

## Query parameters

- `includeFields` string[]
- `includeAllFields` boolean

## Request body

- FieldPublicRequest
  - `fieldId` integer — The field's unique, system-generated identifier, which can be used to identify the field globally.
  - `fieldLabel` string, required — The fieldLabel is the name of the field.
  - `fieldDescription` string — The description of the field.
  - `fieldType` 'TEXT' | 'MULTI_LINE_TEXT' | 'YES_OR_NO' | 'DATE' | 'SINGLE_CHOICE' | 'MULTIPLE_CHOICE' | 'SINGLE_USER' | 'MULTIPLE_USER' | 'NUMBER' | 'NOTE' | 'RATING', required — This defines type of the field. Refer [Custom Fields](https://developer.rocketlane.com/v1.0/docs/custom-fields) for further information
  - `objectType` 'PROJECT' | 'TASK' | 'USER', required — This defines type of object that is associated with the field. This could be `TASK`, `PROJECT` or `USER`.
  - `fieldOptions` FieldOptionPublicRequest[] — The fieldOptions params define the value and label for the different options available for `SINGLE_CHOICE` and `MULTIPLE_CHOICE` fields.
    - `optionColor` 'RED' | 'YELLOW' | 'GREEN' | 'TEAL' | 'CYAN' | 'BLUE' | 'PURPLE' | 'MAGENTA' | 'GRAY' | 'COOL_GRAY', required — The optionColor reflects the color of the options for the single or multiple choice field.
    - `optionLabel` string, required — The optionLabel reflects the name of the options for the single or multiple choice field.
  - `ratingScale` 'THREE' | 'FIVE' | 'SEVEN' | 'TEN' — The number of stars in the Rating Scale when Field Type is `RATING`.
  - `enabled` boolean — This depicts if the field is enabled or not. Only those fields which are enabled will reflect in the account.
  - `private` boolean — This depicts if the field is private or not.

## Response `201`

The resource was successfully created in the database.

- FieldModelPublicResponseAPIEntity
  - `fieldId` integer — The field's unique, system-generated identifier, which can be used to identify the field globally.
  - `fieldLabel` string — The fieldLabel is the name of the custom field
  - `fieldDescription` string — The description of the field
  - `fieldType` 'TEXT' | 'MULTI_LINE_TEXT' | 'YES_OR_NO' | 'DATE' | 'SINGLE_CHOICE' | 'MULTIPLE_CHOICE' | 'SINGLE_USER' | 'MULTIPLE_USER' | 'NUMBER' | 'NOTE' | 'RATING' — This defines type of the field. Refer [Custom Fields](https://developer.rocketlane.com/v1.0/docs/custom-fields) for further information
  - `objectType` string — This defines type of object that is associated with the field. This could be `TASK`, `PROJECT` or `USER`.
  - `fieldOptions` OptionsPublicAPIResponseEntity[] — The fieldOptions params define the value and label for the different options available for `SINGLE_CHOICE` and `MULTIPLE_CHOICE` fields.
    - `optionValue` integer — The optionValue is the unique identifier and is unique for each field.
    - `optionLabel` string — The optionLabel reflects the name of the options for the single or multiple choice field.
    - `optionColor` 'RED' | 'YELLOW' | 'GREEN' | 'TEAL' | 'CYAN' | 'BLUE' | 'PURPLE' | 'MAGENTA' | 'GRAY' | 'COOL_GRAY' — The optionColor reflects the color of the options for the single or multiple choice field.
  - `ratingScale` 'THREE' | 'FIVE' | 'SEVEN' | 'TEN' — The number of stars in the Rating Scale when Field Type is `RATING`.
  - `createdBy` FieldCreatedByUserPublicAPI — The team member who created the field.
    - `emailId` string — The team member's email identifier.
    - `userId` integer — The unique identifier for the team member.
    - `firstName` string — The first name of the team member.
    - `lastName` string — The last name of the team member.
  - `updatedBy` FieldUpdatedByUserPublicAPI — The team member who updated the field.
    - `emailId` string — The team member's email identifier.
    - `userId` integer — The unique identifier for the team member.
    - `firstName` string — The first name of the team member.
    - `lastName` string — The last name of the team member.
  - `createdAt` integer — The time when the field was created. The referenced time will be in epoch millis.
  - `updatedAt` integer — The time when the field was last updated. Any changes that's related to the field are captured and specified here in epoch millis.
  - `enabled` boolean — This depicts if the field is enabled or not. Only those fields which are enabled will reflect in the account.
  - `private` boolean — This depicts if the field is private or not.

## Other responses

- `400` — This error typically happens when the request payload contains an error. If you want to make sure that the request's parameters are named correctly and are the right data types, you can examine the request's syntax.
- `401` — You see this error when trying to access this resource without being authenticated. Check the API request header to make sure it is not empty and has a valid api-key that you acquired from the Rocketlane API Settings tab.

---

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