# Custom Field Options

This group of endpoints allows you to manage the list options for a `LIST` type custom field. Options created via the Public API can be disabled or deleted.

## List custom field options

 - [GET /v1/businesses/{client_id}/custom-fields/{custom_field_id}/options](https://developer.letsweel.com/openapi/custom-field-options/listcustomfieldoptions.md): Returns a paginated list of all options for the given custom field, including disabled ones.

## Create a custom field option

 - [POST /v1/businesses/{client_id}/custom-fields/{custom_field_id}/options](https://developer.letsweel.com/openapi/custom-field-options/createcustomfieldoption.md): Adds a new option to a LIST type custom field.

Not permitted for FREE_TEXT custom fields or custom fields created by accounting integrations.

## Update a custom field option

 - [PATCH /v1/businesses/{client_id}/custom-fields/{custom_field_id}/options/{option_id}](https://developer.letsweel.com/openapi/custom-field-options/updatecustomfieldoption.md): Partially updates a custom field option.

Accounting integration fields (Xero, MYOB, QuickBooks, NetSuite, Business Central): only enabled can be changed. The text field cannot be modified.

Non-accounting-integration fields (MANUAL, PUBLIC_API): only text can be changed. The enabled field cannot be modified — delete and recreate options instead.

## Delete a custom field option

 - [DELETE /v1/businesses/{client_id}/custom-fields/{custom_field_id}/options/{option_id}](https://developer.letsweel.com/openapi/custom-field-options/deletecustomfieldoption.md): Permanently deletes a custom field option.

Not permitted for options belonging to custom fields created by accounting integrations.