---
title: "Create catalog collections"
method: POST
path: "/v2/catalog/collections"
tags: ["catalog"]
---

# Create catalog collections

`POST /v2/catalog/collections`

This endpoint creates a catalog collection and optionally adds assets. To add assets to the collection later, use `PATCH /v2/catalog/collections/{collection_id}/items`.

## Request body

- object
  - `name` string, required
  - `visibility` 'private' | 'public'
  - `items` object[]
    - `asset` object, required
      - `id` string
      - `type` string, required

## Response `201`

OK

- object — Catalog collection
  - `id` string, required
  - `name` string, required
  - `cover_asset` object — Metadata about an item that is part of a collection
    - `id` string, required
    - `asset` object, required
      - `id` string
      - `type` 'image' | 'video' | 'audio' | 'editorial-image' | 'editorial-video', required
      - `name` string
    - `created_time` string, date-time, required
    - `collection_ids` string[] — The collection IDs that this asset belongs to
  - `total_item_count` number, required
  - `created_time` string, date-time, required
  - `updated_time` string, date-time, required
  - `visibility` 'private' | 'public', required
  - `role_assignments` object, required — List of role assignments for a catalog collection
    - `collection_id` string, required
    - `roles` object, required
      - `owners` object[]
        - `id` string, required
        - `type` 'USER', required
        - `email` string, required
      - `editors` object[]
        - `id` string, required
        - `type` 'USER', required
        - `email` string, required
      - `viewers` object[]
        - `id` string, required
        - `type` 'USER', required
        - `email` string, required

---

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