---
title: "Create a dropdown option for a List Field"
method: POST
path: "/v2/lists/{listId}/fields/{fieldId}/dropdown-options"
tags: ["Lists"]
---

# Create a dropdown option for a List Field

`POST /v2/lists/{listId}/fields/{fieldId}/dropdown-options`

Create a dropdown option for a List Field.

## Path parameters

- `listId` integer, required
- `fieldId` string, required

## Request body

- union
  - DropdownOptionsStandardDropdownOptionToBeCreated
    - `type` 'dropdown', required — The type of dropdown option
    - `text` string, required — Dropdown option text
  - DropdownOptionsRankedDropdownOptionToBeCreated
    - `type` 'ranked-dropdown', required — The type of dropdown option
    - `text` string, required — Dropdown option text
    - `rank` integer, required — Dropdown option rank (sort order)
    - `color` 'white' | 'gray' | 'blue' | 'green' | 'purple' | 'orange' | 'red', required — Dropdown option color
  - DropdownOptionsStatusDropdownOptionToBeCreated
    - `type` 'status-dropdown', required — The type of dropdown option
    - `text` string, required — Dropdown option text
    - `rank` integer, required — Dropdown option rank (sort order)
    - `color` 'white' | 'gray' | 'blue' | 'green' | 'purple' | 'orange' | 'red', required — Dropdown option color
    - `statusCategory` 'open' | 'won' | 'lost' | 'on-hold', required — Dropdown option's status category
    - `winRate` integer — The user-designated probability that an entity in this status will progress to a `won` status. Only valid when `statusCategory` is `open`. Must be an integer between 0 and 100 inclusive.

## Response `201`

Created

- union
  - DropdownOptionsDropdownOption
    - `id` integer, required — Dropdown option's unique identifier
    - `text` string, required — Dropdown option text
  - DropdownOptionsRankedDropdownOption
    - `id` integer, required — Dropdown option's unique identifier
    - `text` string, required — Dropdown option text
  - DropdownOptionsStatusDropdownOption
    - `id` integer, required — Dropdown option's unique identifier
    - `text` string, required — Dropdown option text

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `default` — Errors

---

[API](https://skmtc.dev/affinity/apis/affinity-api-v2.md) · [All operations](https://skmtc.dev/affinity/apis/affinity-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/affinity/affinity-api-v2/revisions/4c2891c31b7f/schema)