---
title: "Create Custom Field Option"
method: POST
path: "/transactions/custom-fields/{customFieldId}/options"
tags: ["Custom Fields"]
---

# Create Custom Field Option

`POST /transactions/custom-fields/{customFieldId}/options`

Add a new, single [custom field option](/docs/custom-fields-on-transactions) to a given custom field of type `SELECT`.

## Path parameters

- `customFieldId` string, uuid, required

## Query parameters

- `organizationId` string, uuid, required

## Request body

- object
  - `name` string, required — The name of the custom field option, readable for humans.
  - `value` string, required — The value of the custom field option. This is mostly your internal value you want to process.
  - `isDefault` boolean, required — If set to true, this means this custom field option is the default option for the related custom field.

## Response `200`

Ok. The custom field option can be used after you received the callback for the `CUSTOM_FIELD_OPTION_CREATED` event.

- object
  - `data` object[]
    - `id` string, uuid — The id of the custom field option.
    - `customFieldId` string, uuid — The id of the custom field this option belongs to.
    - `name` string — The name of the custom field option, readable for humans.
    - `value` string — The value of the custom field option. This is mostly your internal value you want to process.
    - `status` 'ACTIVE' | 'INACTIVE' — The status of the custom field option. Only an active custom field option can be used.
    - `source` 'PLIANT' | 'API' | 'ACCOUNTING_SYSTEM' — The source of the custom field option, i.e. how it was created. `PLIANT` means it was created via the Pliant web app. `API` means it was created via the Pliant API. `ACCOUNTING_SYSTEM` means it was created via the accounting system used by the organization.
    - `externalReference` string, nullable — The external reference of the custom field option. This is the reference in the accounting system and used only there.
    - `isDefault` boolean — If set to true, this means this custom field option is the default option for the related custom field.
    - `createdAt` string, date-time — The date and time the custom field option was created.
    - `updatedAt` string, date-time — The date and time the custom field option was last updated.

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `429` — unresolved $ref
- `500` — unresolved $ref

---

[API](https://skmtc.dev/getpliant/apis/pliant-customer-api.md) · [All operations](https://skmtc.dev/getpliant/apis/pliant-customer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getpliant/pliant-customer-api/revisions/f3f589cfa718/schema)