---
title: "Create a new collection"
method: POST
path: "/v1/collections"
tags: ["Collections"]
---

# Create a new collection

`POST /v1/collections`

Create a new collection and automatically add the creating user
to it.

This endpoint allows authenticated users to create a new collection
with a specified name and optional description. The user creating
the collection is automatically added as a member.

## Request body

- CreateCollectionRequest
  - `description` string, nullable
  - `name` string, required
  - `workspace_id` string, uuid, nullable

## Response `200`

Successful Response

- NebulaResultsCollectionResponse
  - `results` CollectionResponse, required
    - `access_tier` string, nullable
    - `cache_policy` string, nullable
    - `chain_type` string, nullable
    - `contract_address` string, nullable
    - `created_at` string, date-time, required
    - `creator_royalty_bps` integer, nullable
    - `description` string, nullable, required
    - `engram_count` integer, required
    - `graph_collection_status` string, required
    - `graph_sync_status` string, required
    - `has_preview_access` boolean, nullable
    - `id` string, uuid, required
    - `is_forked` boolean, nullable
    - `marketplace_metadata` object, nullable
    - `memory_count` integer, nullable
    - `name` string, required
    - `nft_collection_address` string, nullable
    - `owner_email` string, nullable
    - `owner_id` string, uuid, nullable, required
    - `owner_name` string, nullable
    - `preview_query_limit` integer, nullable
    - `purchase_price_usd` string, nullable
    - `rental_price_monthly_usd` string, nullable
    - `updated_at` string, date-time, required
    - `user_count` integer, required
    - `workspace_id` string, uuid, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-04-27** `b1da2c0bb1ae` — 11 info
  - api operation id `create_collection_v1_collections_post` removed and replaced with `create_collection`
  - api tag `Collections` added
  - added the new optional request property `workspace_id`
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - …7 more

[Change history](https://skmtc.dev/zeroset-inc/apis/nebula-api/changes/v1/collections/post.md)

---

[API](https://skmtc.dev/zeroset-inc/apis/nebula-api.md) · [All operations](https://skmtc.dev/zeroset-inc/apis/nebula-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zeroset-inc/nebula-api/revisions/b1da2c0bb1ae/schema)