Skip to main content
POST
/
products
/
collections
Create Product Collection
curl --request POST \
  --url https://services.leadconnectorhq.com/products/collections \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Version: <version>' \
  --data '
{
  "altId": "6578278e879ad2646715ba9c",
  "altType": "LOCATION",
  "name": "Best Sellers",
  "slug": "best-sellers",
  "collectionId": "66057f9d28536eae584ec047",
  "image": "http://example.com/watermark.png",
  "type": "manual",
  "rules": {
    "logic": "AND",
    "conditions": [
      "<array>"
    ]
  },
  "productIds": [
    "655b33a82209e60b6adb87a5",
    "655b33a82209e60b6adb87a6"
  ],
  "seo": {
    "title": "Best Sellers",
    "description": "Collections where all the best products are available"
  },
  "ruleHash": "abc123def456",
  "ruleVersion": 1,
  "stats": {}
}
'
{
  "data": {
    "_id": "655b33a82209e60b6adb87a5",
    "altId": "Z4Bxl8J4SaPEPLq9IQ8g",
    "name": "Best Sellers",
    "slug": "best-sellers",
    "type": "manual",
    "createdAt": "2024-02-22T09:27:19.728Z",
    "image": "http://example.com/watermark.png",
    "seo": {
      "title": "Best Sellers",
      "description": "Collections where all the best products are available"
    },
    "rules": {},
    "ruleVersion": 1,
    "ruleHash": "abc123def456",
    "stats": {}
  }
}

Authorizations

​
Authorization
string
header
required

Use the Access Token generated with user type as Sub-Account (OR) Private Integration Token of Sub-Account.

Headers

​
Version
enum<string>
required

API Version

Available options:
2021-07-28

Body

application/json
​
altId
string
required

Location Id

Example:

"6578278e879ad2646715ba9c"

​
altType
enum<string>
required

The type of alt. For now it is only LOCATION

Available options:
location
Example:

"LOCATION"

​
name
string
required

Name of the Product Collection

Example:

"Best Sellers"

​
slug
string
required

Slug of the Product Collection which helps in navigation

Example:

"best-sellers"

​
collectionId
string

Unique Identifier of the Product Collection, Mongo Id

Example:

"66057f9d28536eae584ec047"

​
image
string

The URL of the image that is going to be displayed as the collection Thumbnail

Example:

"http://example.com/watermark.png"

​
type
enum<string>

Type of collection - manual or smart

Available options:
manual,
smart
Example:

"manual"

​
rules
object
​
productIds
string[]

Array of product IDs for manual collections (required if type is manual)

Example:
[
  "655b33a82209e60b6adb87a5",
  "655b33a82209e60b6adb87a6"
]
​
seo
object
​
ruleHash
string

Hash of the rules for change detection (auto-generated)

Example:

"abc123def456"

​
ruleVersion
number

Version of the rules for smart collections (auto-generated)

Example:

1

​
stats
object

Statistics about the collection (auto-generated)

Response

Successful response

​
data
object
required
Last modified on March 4, 2026