Skip to main content
POST
/
api
/
v1
/
hub
/
shop
/
{shopId}
/
collections
Create Collection
curl --request POST \
  --url https://api.sabivendor.com/api/v1/hub/shop/{shopId}/collections \
  --header 'Content-Type: application/json' \
  --header 'X-Shop-API-Key: <x-shop-api-key>' \
  --data '
{
  "name": "<string>",
  "slug": "<string>",
  "description": "<string>"
}
'
{
  "status": "success",
  "message": "Collection created successfully",
  "data": {
    "id": 1,
    "name": "Winter Specials",
    "slug": "winter-specials",
    "description": null,
    "imageUrl": null,
    "isActive": true
  }
}
Creates a new curated product collection. Allows you to upload a collection thumbnail image file.

​
Authorizations

​
X-Shop-API-Key
string
required
Your Secret API Key (sk_live_... or sk_test_...) generated from the Developer dashboard. Must be kept secret.

​
Path Parameters

​
shopId
string
required
The unique UUID of the shop.

​
Request Body (Multipart / Form Data)

​
name
string
required
Collection display name.
​
slug
string
required
URL slug format (alphanumeric and dashes).
​
description
string
Collection details.
​
image
file
Collection display icon/image file.
{
  "status": "success",
  "message": "Collection created successfully",
  "data": {
    "id": 1,
    "name": "Winter Specials",
    "slug": "winter-specials",
    "description": null,
    "imageUrl": null,
    "isActive": true
  }
}