---
title: "Update transaction custom fields"
method: PUT
path: "/v3/spend/transactions/{transactionId}/custom-fields"
tags: ["transactions"]
---

# Update transaction custom fields

`PUT /v3/spend/transactions/{transactionId}/custom-fields`

Update details about custom fields and their values applied to an existing transaction.

You cannot update custom fields in a locked transaction. When a transaction is locked, `isLocked` is set as `true`. You can get information about your transactions with `GET /v3/spend/transactions` or `GET /v3/spend/transactions/{transactionId}.

See [Lock or unlock custom fields for a transaction](https://help.bill.com/direct/s/article/4278891) in the BILL Help Center for more information.

## Path parameters

- `transactionId` string, required — BILL-generated ID or UUID of the transaction

## Headers

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

## Request body

- BulkUpdateTxCustomFieldRequestDto — Transaction Custom Fields update request dto.
  - `customFields` UpdateCustomFieldDto[], required — List of custom field and value updates
    - `customFieldId` string, required — BILL-generated ID or UUID of the custom field
    - `selectedValues` string[] — List of selected custom field values. Set the custom field value ID or UUID values. **Note**: Clear the `selectedValues` array to clear all the custom field selected values.
    - `note` string — Updated custom field note. **Note**: This field is available only for custom fields with `type` set as `NOTE`.

## Response `200`

Update transaction custom fields response

- SpendStatusDto — Simple DTO to respond to requests with a status of "success".
  - `status` string — Status of the request, e.g. "SUCCESS"

## 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/versions/0483350c434e/schema)