---
title: "Create Collection"
method: POST
path: "/v2/collections"
tags: ["external", "external-v2"]
---

# Create Collection

`POST /v2/collections`

Create a collection with optional caller-provided ID and timestamps.
If `id` already exists, this request returns a conflict.
Use collection membership endpoints to add, remove, or move notes between collections.

## Request body

- CreateCollectionRequestSchema
  - `created_at` string, date-time, nullable — Optional creation timestamp (ISO 8601). If provided, it must include a timezone offset and cannot be in the future. If omitted, Mem uses `updated_at` when provided; otherwise current server time.
  - `description` string, nullable — Optional descriptive text for collection scope or intent. Maximum: 10,000 characters (and no more than 10,000 UTF-8 bytes).
  - `id` string, uuid, nullable — Optional caller-provided UUID for the collection. If omitted, Mem generates a new UUID. If the provided ID already exists, this request returns a conflict.
  - `title` string, required — Title for the collection. Use a short, stable label suitable for navigation and search. Maximum: 1,000 characters (and no more than 1,000 UTF-8 bytes).
  - `updated_at` string, date-time, nullable — Optional "last updated" timestamp for this write (ISO 8601). If provided, it must include a timezone offset and cannot be in the future. If omitted, Mem uses `created_at` for the initial collection write.

## Response `200`

OK

- CreateCollectionResponseSchema
  - `created_at` string, date-time, required — Creation timestamp for the collection in ISO 8601 format.
  - `description` string, nullable, required — Optional description text currently stored on the collection.
  - `id` string, uuid, required — UUID of the created collection.
  - `request_id` string, required — Identifier for this API request. Useful for tracing and support.
  - `title` string, required — Current title of the collection.
  - `updated_at` string, date-time, required — Last modification timestamp for the collection in ISO 8601 format.

---

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