---
title: "Set Custom Field Value"
method: POST
path: "/v2/task/{task_id}/field/{field_id}"
tags: ["Custom Fields"]
---

# Set Custom Field Value

`POST /v2/task/{task_id}/field/{field_id}`

Add data to a Custom field on a task. \
 \
You'll need to know the `task_id` of the task you want to update, and the universal unique identifier (UUID) `field_id` of the Custom Field you want to set. \
 \
The Custom Field must be applicable to the task's current `custom_item_id`. Use [Get Custom Fields](https://developer.clickup.com/reference/getaccessiblecustomfields) (check each field's `applied_objects`) or [Get Task](https://developer.clickup.com/reference/gettask) to find applicable `field_id` values.\
 \
Returns `400` if the field is not enabled for the task's custom task type.

## Path parameters

- `task_id` string, required
- `field_id` string, required

## Query parameters

- `custom_task_ids` boolean
- `team_id` number

## Request body

- union
  - object — The `value` must be a string with a valid URL.
    - `value` string, required
  - object — Enter the universal unique identifier (UUID) of the dropdown menu option you want to set. You can find the UUIDs available for each Dropdown Custom Field using [Get Accessible Custom Fields.](https://developer.clickup.com/reference/getaccessiblecustomfields) New Dropdown Custom Field options cannot be created from this request.
    - `value` string, required
  - object — The `value` must be a string with a valid email address.
    - `value` string, required
  - object — The `value` must be a string with a valid country code.
    - `value` string, required
  - object — The `value` must be Unix time in milliseconds. To display the time in a Date Custom Field in ClickUp, you must include `time: true` in the `value_options` property.
    - `value` integer
    - `value_options` object
      - `time` boolean, required
  - object — Enter a string of text.
    - `value` string, required
  - object — Enter a number.
    - `value` number, required
  - object — You can set an amount, but not the currency of a Money Custom Field via the API. You can check the currency of a Money Custom Field using [Get Accessible Custom Fields.](https://developer.clickup.com/reference/getaccessiblecustomfields)
    - `value` number, required
  - object — Enter an array of task ids in the `add` property to add them to a Task Relationship Custom Field. Enter them into the `rem` property to remove tasks from the Relationship.
    - `value` object, required
      - `add` string[]
      - `rem` string[]
  - object — Enter an array of user ids or a Team id in the `add` property to add them to a People Custom Field. Enter them into the `rem` property to remove users from a People Custom Field. You can get a list of people in the Workspace using [Get Authorized Teams (Workspaces).](https://developer.clickup.com/reference/getauthorizedteams)
    - `value` object, required
      - `add` number[]
      - `rem` number[]
  - object — Enter the ID of an attachment uploaded to a `custom_fields` entity using our [V3 Create Attachment](https://developer.clickup.com/reference/postEntityAttachment) endpoint.
    - `value` object, required
      - `add` string[]
      - `rem` string[]
  - object — Enter an integer that is greater than or equal to zero and where the `count` property is greater than or equal to the `value`. You can find the `count` property for each Emoji (Rating) Custom Field using [Get Accessible Custom Fields.](https://developer.clickup.com/reference/getaccessiblecustomfields)
    - `value` integer, required
  - object — Enter a number between the `start` and `end` values of each Manual Progress Custom Field. For example, for a field with `start: 10` and `end: 30`, sending `current: 20` will be displayed as 50% complete in ClickUp. You can find the `start` and `end` values for each Manual Progress Custom Field using [Get Accessible Custom Fields.](https://developer.clickup.com/reference/getaccessiblecustomfields)
    - `value` object, required
      - `current` number, required
  - object — Enter an array of the universal unique identifiers (UUIDs) of the labels you want to apply. You can find the UUIDs available for each Label Custom Field using [Get Accessible Custom Fields.](https://developer.clickup.com/reference/getaccessiblecustomfields)
    - `value` string[], required
  - object — Include the latitude, longitude, and formatted address as defined in the [Google Maps Geocoding API.](https://developers.google.com/maps/documentation/geocoding/overview)
    - `value` object, required
      - `location` object
        - `lat` number
        - `lng` number
      - `formatted_address` string
  - object — Set a button Custom Field to `true` to "click" it. This will trigger the button's action as if it was clicked in the UI.
    - `value` boolean, required

## Response `200`

- object

## Other responses

- `400` — Returned when the Custom Field is not applicable to the task's custom task type.

---

[API](https://skmtc.net/clickup/apis/clickup-api-v2-reference.md) · [All operations](https://skmtc.net/clickup/apis/clickup-api-v2-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clickup/clickup-api-v2-reference/versions/72216f55b952/schema)