---
title: "Create a custom field value"
method: POST
path: "/v3/spend/custom-fields/{customFieldId}/values"
tags: ["custom-fields"]
---

# Create a custom field value

`POST /v3/spend/custom-fields/{customFieldId}/values`

Create a new value for an existing custom field.

## Path parameters

- `customFieldId` string, required — BILL-generated ID or UUID of the custom field

## Headers

- `apiToken` string, nullable — Access token for Spend & Expense API authentication

## Request body

- CreateCustomFieldValueRequestDto — Create a custom field value (value added to existing list)
  - `values` string[], required — List of custom field values

## Response `200`

Create a custom field value response

- CustomFieldValueResponseDto — DTO representing a custom field value response.
  - `id` string — BILL-generated ID of the custom field value
  - `uuid` string — BILL-generated UUID of the custom field value
  - `value` string — Custom field value
  - `deleted` boolean — Set as `true` if the custom field value is retired

## Other responses

- `4XX` — List of errors.
- `5XX` — List of errors.

---

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