---
title: "Create a dropdown"
method: POST
path: "/dropdowns"
tags: ["dropdowns"]
---

# Create a dropdown

`POST /dropdowns`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/dropdowns`
- Auth: HTTP bearer

Create a dropdown

## Request body

- DropdownCreate
  - `name` string, required: Name of the dropdown
  - `options` DropdownOptionCreate[], required: Options to set for the dropdown
    - `name` string, required
  - `registryId` string, nullable: ID of registry in which to create the dropdown. Required if multiple registries exist.

## Response `200`

Created

- Dropdown: Dropdowns are registry-wide enums. Use dropdowns to standardize on spelling and naming conventions, especially for important metadata like resistance markers.
  - `id` string: ID of the dropdown
  - `name` string: Name of the dropdown
  - `archiveRecord` ArchiveRecord
    - `reason` string
  - `options` DropdownOption[]: Array of dropdown options
    - `archiveRecord` ArchiveRecord
      - `reason` string
    - `id` string
    - `name` string

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/benchling/apis/benchling-api-2.md) - [All operations](https://skmtc.dev/benchling/apis/benchling-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/benchling/apis/benchling-api-2/revisions/01d2fa8523cd?raw)
