---
title: "Create a new collection"
method: POST
path: "/api/v1/collections"
tags: ["Collections"]
---

# Create a new collection

`POST /api/v1/collections`

## Request

- Base URL: `https://api.instadram.me/v1`
- URL: `https://api.instadram.me/v1/api/v1/collections`
- Auth: HTTP bearer

## Request body

- CreateCollectionRequest
  - `name` string, required: Collection name
  - `description` string: Collection description
  - `image_url` string: Collection image URL

## Response `201`

Collection created successfully

- object
  - `success` boolean
  - `data` Collection
    - `id` string: Collection ID
    - `name` string: Collection name
    - `description` string: Collection description
    - `image_url` string: Collection image URL
    - `created_at` string, date-time: Creation timestamp
    - `updated_at` string, date-time: Last update timestamp
    - `is_system` boolean: Whether this is a system collection
    - `type` string: Collection type
    - `bottle_count` integer: Number of bottles in collection

---

[API](https://skmtc.dev/instadram/apis/instadram-api.md) · [All operations](https://skmtc.dev/instadram/apis/instadram-api/llms.txt) · [OpenAPI document](https://skmtc.dev/instadram/apis/instadram-api/revisions/2971df0f7ef1?raw)