---
title: "Create collection"
method: POST
path: "/api/v1/collections"
tags: ["collections"]
---

# Create collection

`POST /api/v1/collections`

Create a new collection in the workspace.

    This endpoint creates a collection with the specified name. Collections are used to organize scenes and manage permissions.

    **Use cases:**
    - Organizing scenes by project, team, or topic
    - Automating collection creation for onboarding flows
    - Integrating with external project management tools

## Request body

- object
  - `name` string, required

## Response `200`

This response returns the newly created collection.

- object — This response returns the newly created collection.
  - `id` string, required
  - `isDefault` boolean
  - `workspace` string, required
  - `creator` string, required
  - `updater` string
  - `teams` string[], required
  - `created` string, date-time, required
  - `sortOrder` string
  - `name` string, required
  - `updated` string, date-time, required
  - `isDeleted` boolean
  - `emoji` object
    - `id` string, required
    - `native` string, required
    - `unified` string, required
  - `deletedAt` number

## Other responses

- `400` — This response indicates that the request was malformed or contained invalid parameters.
- `401` — This response indicates that the client must authenticate to access the requested resource.
- `403` — This response indicates that the client does not have permission to access the requested resource.

---

[API](https://skmtc.net/excalidraw/apis/excalidraw-api.md) · [All operations](https://skmtc.net/excalidraw/apis/excalidraw-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/excalidraw/excalidraw-api/revisions/c1404d1545ba/schema)