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

# Create Collection

`POST /Collections`

## Request

- Base URL: `https://api.shopmy.us/v1/Partners`
- URL: `https://api.shopmy.us/v1/Partners/Collections`
- Auth: API key in header `Authorization`

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.dev/shopmy/apis/shopmy-for-developers.md) - [All operations](https://skmtc.dev/shopmy/apis/shopmy-for-developers/llms.txt) - [OpenAPI document](https://skmtc.dev/shopmy/apis/shopmy-for-developers/revisions/9beecb9e11f7?raw)