---
title: "Create Collection"
method: POST
path: "/Collections"
---

# Create Collection

`POST /Collections`

This API route allows a developer application to create a ShopMy collection for a user. This route requires the user to permission your app for the write_collections scope. Partner-created collections are always public.

## Request body

- object
  - `name` string, required — Collection name (required)
  - `description` string — Collection description (optional)
  - `social_links` union — Social URLs attached to the collection. Each link must be an HTTPS Instagram, TikTok, or YouTube URL. May be sent as an array or comma-separated string (optional).
    - string[]
    - string
  - `Section_id` integer — Section to place the collection in. The section must belong to the authenticated user. If omitted, ShopMy uses the user's first standard shop section when available (optional).

## Response `200`

200

- object
  - `success` boolean, required
  - `collection` Collection, required
    - `id` integer, required
    - `name` string, required
    - `description` string
    - `image` string, nullable
    - `social_links` string[], required
    - `private` boolean, required
    - `Section_id` integer, nullable
    - `url` string, required

## Other responses

- `400` — 400
- `401` — 401

---

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