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

# Create a Collection

`POST /collections`

Create a new collection in Directus.

## Query parameters

- `meta` string

## Request body

- object
  - `collection` string, required — Unique name of the collection.
  - `fields` object[], required — The fields contained in this collection. See the fields reference for more information. Each individual field requires field, type, and interface to be provided.
  - `icon` string, nullable — Name of a Google Material Design Icon that's assigned to this collection.
  - `note` string, nullable — A note describing the collection.
  - `display_template` string, nullable — Text representation of how items from this collection are shown across the system.
  - `hidden` boolean — Whether or not the collection is hidden from the navigation in the admin app.
  - `singleton` boolean — Whether or not the collection is treated as a single object.
  - `translation` string, nullable — Key value pairs of how to show this collection's name in different languages in the admin app.
  - `versioning` boolean — Whether or not Content Versioning is enabled for this collection.
  - `archive_field` string, nullable — What field holds the archive value.
  - `archive_app_filter` string, nullable — What value to use for "archived" items.
  - `archive_value` string, nullable — What value to use to "unarchive" items.
  - `unarchive_value` string, nullable — Whether or not to show the "archived" filter.
  - `sort_field` string, nullable — The sort field in the collection.

## Response `200`

Successful request

- object
  - `data` Collections
    - `collection` string — The collection key.
    - `icon` string, nullable
    - `note` string, nullable
    - `display_template` string, nullable
    - `hidden` boolean
    - `singleton` boolean
    - `translations` unknown
    - `archive_field` string, nullable
    - `archive_app_filter` boolean
    - `archive_value` string, nullable
    - `unarchive_value` string, nullable
    - `sort_field` string, nullable
    - `accountability` string, nullable
    - `color` string, nullable
    - `item_duplication_fields` unknown
    - `sort` integer, nullable
    - `group` union
      - string
      - Collections — recursive
    - `collapse` string
    - `preview_url` string, nullable
    - `versioning` boolean

## Other responses

- `401` — Error: Unauthorized request
- `404` — Error: Not found.

---

[API](https://skmtc.dev/utomic-media/apis/dynamic-api-specification.md) · [All operations](https://skmtc.dev/utomic-media/apis/dynamic-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/utomic-media/dynamic-api-specification/revisions/4a0ccd34700e/schema)