COL

Collection CRUD

Commerce & Products · Basic · Updated March 2026

Create and manage product collections for organizing catalog items into groups that power storefront navigation and promotional groupings.

Collection CRUD lets you organize products into logical groups. Collections are how storefronts structure their navigation — “New Arrivals,” “Best Sellers,” “Service Packages” — and how promotional campaigns target specific product subsets.

What This MCP Tool Does

This tool handles creation and retrieval of product collections. Group related products together for storefront display, marketing campaigns, and catalog organization. Collections are particularly useful when a client sells across multiple categories.

Endpoint Reference

Create a collection: POST /products/collections Create a new product collection with name, description, and product assignments.

List all collections: GET /products/collections Retrieve all product collections in the sub-account.

Authentication

Requires a Private Integration Token (PIT) with the products scope enabled.

Key Parameters

When creating a collection:

name — display name for the collection
description — optional description
Product associations linking catalog items to the collection

Important Notes

Collections are organizational containers. They do not affect pricing, inventory, or order processing. Their primary function is display and grouping.

A product can belong to multiple collections simultaneously. A product might appear in both “Best Sellers” and “Summer Specials” without conflict.

For agencies setting up client storefronts programmatically, creating collections as part of the provisioning process ensures the store launches with proper navigation structure.

Common Questions

Can I add products to a collection after creating it? Check the endpoint documentation for update capabilities. Collection-product associations may be managed through creation parameters or separate association endpoints.

How do collections appear on the storefront? Collections typically map to navigation categories or featured sections on the storefront. The specific presentation depends on the funnel or website template being used.

Is there a limit to how many collections I can create? No hard limit documented, but keep collections meaningful and organized. Dozens of overlapping collections become harder to manage than a clean, intentional structure.

Product CRUD — Manage the products within collections
Store Settings — Configure how the storefront displays collections
Price Manager — Pricing applies to products, not collections