---
title: "Create EnzymeList"
method: POST
path: "/api/v3/enzyme-list"
tags: ["Enzyme List"]
---

# Create EnzymeList

`POST /api/v3/enzyme-list`

## Request

- Base URL: `https://{tenant_name}.benchling.com`
- URL: `https://{tenant_name}.benchling.com/api/v3/enzyme-list`
- Auth: HTTP bearer

Create EnzymeList.

## Headers

- `EARLY-ACCESS` string

## Request body

- CreateEnzymeListInput
  - `description` string, nullable: Description of the Enzyme List
  - `enzymeIds` string[]: API IDs of enzymes from the global restriction-enzyme catalog to include in the new list. Omit to create an empty list. Each ID must be valid and IDs must not repeat within the list.
  - `name` string, required: Leading and trailing whitespace is stripped. Must be non-empty and at most 128 characters. Names are unique per owner (case-insensitive). Duplicate names within the same batch request are rejected when they target the same owner.
  - `ownerId` string, required: The API ID of the user or organization that owns the enzyme list.

## Response `201`

Created

- EnzymeList: Represents a user-curated collection of restriction enzymes for molecular cloning workflows. EnzymeLists allow users and organizations to organize commonly used enzymes into named groups for easy access when planning restriction digests, cloning strategies, or analyzing DNA sequences. Each list has an owner (either a user or organization) who controls access permissions. See `Enzyme` for the individual restriction enzymes that can be added to a list.
  - `__typename` string
  - `createdAt` string, datetime: DateTime the Enzyme List was created
  - `description` string, nullable: Description of the Enzyme List
  - `enzymes` string, uri: List of Enzymes that are part of this Enzyme List
  - `id` string: Id of the Enzyme List
  - `modifiedAt` string, datetime: DateTime the Enzyme List was last modified
  - `name` string: Name of the Enzyme List
  - `owner` OwnerRef
    - `__typename` string
    - `id` string, api_id

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `429`: Too Many Requests
- `500`: Internal Server Error

---

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