---
title: "Create custom field values"
method: POST
path: "/v1/fields/{field_id}/values"
tags: ["Field Values"]
---

# Create custom field values

`POST /v1/fields/{field_id}/values`

Create custom field values (up to 1000 values at once) for a specific field

## Path parameters

- `field_id` string, required

## Headers

- `Idempotency-Key` string, required

## Request body

- CreateFieldValueListBody — Represents the data needed to create multiple field values. It can't contain more than 1000 values at once.
  - `items` CreateFieldValueBody[], required — The list of field values to be created
    - `value` string, required — The display name of the field value
    - `value_id` string, nullable — The value ID or code of the field value; Usually it is a unique identifier for the custom field value in the remote system
    - `remote_id` string, nullable — Remote/external ID of custom field value from external system (e.g. ERP or HRIS system)
    - `is_disabled` boolean, nullable — Indicates whether the field value is disabled. A disabled value is not selectable: it no longer appears as a selectable option in the dropdown and cannot be chosen on new transactions. Records that already use the value are unaffected.

## Response `200`

Create custom field values response

- CreateFieldValueListResponse — Represents a list of field values definition
  - `items` FieldValue[], required — The list of created field values
    - `brex_id` string, required — The internal Brex ID of the field value
    - `remote_id` string, nullable — Remote/external ID of custom field value from external system (e.g. ERP or HRIS system)
    - `value_id` string, nullable — The value ID or code of the field value; Usually it is a unique identifier for the custom field value in the remote system
    - `value` string, required — The display name of the field value
    - `field_id` string, required — The ID of the parent field this value belongs to
    - `updated_at` string, date-time, required — The last updated timestamp of the field value
    - `is_disabled` boolean, required — Indicates whether the field value is disabled. A disabled value is not selectable: it no longer appears as a selectable option in the dropdown and cannot be chosen on new transactions. Records that already use the value are unaffected.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal server error

---

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