---
title: "POST /api/v1/config/collections"
method: POST
path: "/api/v1/config/collections"
tags: ["Collection"]
---

# POST /api/v1/config/collections

`POST /api/v1/config/collections`

## Request body

- Configv1CreateCollectionRequest
  - `collection` Configv1Collection
    - `slug` string — Unique identifier of the Collection. If a `slug` isn't provided, one will be generated based of the `name` field. You can't modify this field after the Collection is created.
    - `name` string — Required. Name of the Collection. You can modify this value after the Collection is created.
    - `created_at` string, date-time — Timestamp of when the Collection was created. Cannot be set by clients.
    - `updated_at` string, date-time — Timestamp of when the Collection was last updated. Cannot be set by clients.
    - `team_slug` string — Required slug of the team the collection belongs to.
    - `description` string — Optional description of the collection.
    - `notification_policy_slug` string — Slug of the notification policy used by default for monitors in this collection. This is optional if the collection does not contain monitors or all of its monitors explicitly reference a policy. This does not override the policy used when a monitor explicitly references a policy.
  - `dry_run` boolean — If true, the Collection isn't created, and no response Collection will be returned. The response will return an error if the given Collection is invalid.

## Response `200`

A successful response containing the created Collection.

- Configv1CreateCollectionResponse
  - `collection` Configv1Collection
    - `slug` string — Unique identifier of the Collection. If a `slug` isn't provided, one will be generated based of the `name` field. You can't modify this field after the Collection is created.
    - `name` string — Required. Name of the Collection. You can modify this value after the Collection is created.
    - `created_at` string, date-time — Timestamp of when the Collection was created. Cannot be set by clients.
    - `updated_at` string, date-time — Timestamp of when the Collection was last updated. Cannot be set by clients.
    - `team_slug` string — Required slug of the team the collection belongs to.
    - `description` string — Optional description of the collection.
    - `notification_policy_slug` string — Slug of the notification policy used by default for monitors in this collection. This is optional if the collection does not contain monitors or all of its monitors explicitly reference a policy. This does not override the policy used when a monitor explicitly references a policy.

## Other responses

- `400` — Cannot create the Collection because the request is invalid.
- `409` — Cannot create the Collection because there is a conflict with an existing Collection.
- `500` — An unexpected error response.
- `default` — An undefined error response.

---

[API](https://skmtc.net/chronosphere/apis/config-v1-api.md) · [All operations](https://skmtc.net/chronosphere/apis/config-v1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chronosphere/config-v1-api/versions/530951bd2ccf/schema)