# NewOptionValueInput

input type

Create-input for an OptionValue. The tenant (org group) is derived SERVER-SIDE from the principal; optionGroupId (the parent pick-source) is tenant-scoped server-side and must be active (STRICT — a value may not be born under a non-active group).

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `caption` | [String](/types/#scalars) | no | Optional: when omitted the per-type default applies — the merchant code when given, else 'Option value'; when supplied it must be non-blank. |
| `optionGroupId` | [ID](/types/#scalars) `ID!` | yes | The parent OptionGroup id. |
| `ordinal` | [Int](/types/#scalars) | no | Optional pick-list position (0..1000000) — defaults to 0. |
| `code` | [String](/types/#scalars) | no | No further notes. |

## Used by

- [createOptionValue](/reference/option-value/createOptionValue/)