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

# Create a collection

`POST /collections`

## Request

- Base URL: `https://preview.api.upcontent.com`
- URL: `https://preview.api.upcontent.com/collections`
- Auth: OAuth 2
  - Authorization code: `https://accounts.upcontent.com/authorize`
  - Token URL: `https://accounts.upcontent.com/token` scopes: `upcontent.write`

## Request body

- object
  - `name` string, required: Collection name
  - `description` string: Collection description

## Response `201`

Created

- Collection: Collection object
  - `id` string, required: UUID for the collection
  - `name` string, required: Collection name
  - `created` string, required: Date collection was created, ISO format
  - `updated` string, required: Date collection was updated, ISO format
  - `suggestions` string: URL for the collection of suggestions in this topic

## Other responses

- `400`: Bad request
- `401`: Not authenticated
- `403`: Forbidden
- `404`: Not found

---

[API](https://skmtc.dev/upcontent/apis/upcontent-platform-api.md) - [All operations](https://skmtc.dev/upcontent/apis/upcontent-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upcontent/apis/upcontent-platform-api/revisions/2f89c14d62a9?raw)