---
title: "Create a collection"
method: POST
path: "/brandfolders/{brandfolder_id}/collections"
tags: ["collections"]
---

# Create a collection

`POST /brandfolders/{brandfolder_id}/collections`

Creates a collection in the matching Brandfolder.

## Request body

- object
  - `data` object, required
    - `attributes` object, required
      - `name` string, required — A name.
      - `slug` string — A URL-friendly slug. Use only letters, numbers, hyphens, and underscores. NOTE: We recommend **not** to invent your own slug. If it is not unique and valid, the request fails with a `422` error. Default is to automatically assign a slug based on `name` (a name of \"My Collection\" would make a slug of \"my-collection\").
      - `tagline` string — A tag line.

## Response `200`

The new collection.

- Collection
  - `id` string, required — Unique identifier for the resource instance.
  - `type` 'collections', required — The type of the resource.
  - `attributes` CollectionAttributes, required
    - `name` string — The name of the collection.
    - `tagline` string — The tagline of the collection.
    - `slug` string — The URL-friendly slug of the collection.
    - `public` boolean — Set to `true` for hassle-free sharing, allowing search engines to index your brand assets. Otherwise, set to `false` to share only with the users you specify.
    - `stealth` boolean — Set to `true` to remove the collection from appearing in web searches.
    - `is_workspace` boolean — Set to `true` if the collection is a Brandfolder workspace.

## Other responses

- `default` — Generic error payload

---

[API](https://skmtc.net/smartsheet/apis/brandfolder-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/brandfolder-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/brandfolder-openapi-reference/revisions/fd95b0a2d2f8/schema)