---
title: "Create a worklist"
method: POST
path: "/worklists"
tags: ["worklists"]
---

# Create a worklist

`POST /worklists`

## Request

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

Create a worklist

## Request body

- WorklistCreate
  - `collaborations` CollaborationCreate[]
    - union
      - PrincipalCollaborator
        - `accessPolicyId` string, required
        - `collaboratorId` string, required
      - MemberCollaborator: TEAM and ORGANIZATION collaborator groups must also specify the role of the collaborator.
        - `accessPolicyId` string, required
        - `collaboratorId` string, required
        - `role` 'ADMIN' | 'MEMBER', required
  - `name` string, required: Name of the worklist
  - `type` 'batch' | 'bioentity' | 'container' | 'plate', required: The type of items a worklist contains.
  - `worklistItemIds` string[]: An ordered set of IDs to assign as worklist items. IDs should reference existing items which fit the worklist's specific type. For instance, a worklist of type container should only have item IDs which represent containers.

## Response `201`

Created

- Worklist: A worklist and its items as summaries.
  - `apiURL` string, uri: The canonical url of the Worklist in the API.
  - `createdAt` string, date-time: Date and time the worklist was created
  - `creator` WorklistCreator: UserSummary of the user who created the worklist
    - `handle` string
    - `id` string
    - `name` string
  - `id` string: ID of the worklist
  - `modifiedAt` string, date-time: Date and time the worklist was last modified
  - `name` string: Name of the worklist
  - `type` 'batch' | 'bioentity' | 'container' | 'plate': The type of items a worklist contains.
  - `worklistItems` WorklistItemSummary[]
    - `id` string: ID of the item
    - `name` string: Name of the item

## Other responses

- `400`: Bad Request

---

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