Updated 2026-06-01

Store API: Products

List, get, create, update, and delete products via the Store API.

The products resource exposes full CRUD for your catalog via the Store API.

Product endpoints
GET/v1/store/products
List products. Filters: status, productType, category, collection, brand, search, sort.
Publishable key
GET/v1/store/products/:id
Get a single product.
Publishable key
POST/v1/store/products
Create a product.
Secret key
PATCH/v1/store/products/:id
Update a product.
Secret key
DELETE/v1/store/products/:id
Delete a product.
Secret key

Example: list products

bash
curl -X GET "https://api.saleporia.com/v1/store/products?status=Published&limit=20" \
  -H "Authorization: Bearer sp_pub_xxxxxxxxxxxx"

Example: create a product

bash
curl -X POST "https://api.saleporia.com/v1/store/products" \
  -H "Authorization: Bearer sp_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Classic T-Shirt",
    "price": 29.99,
    "productType": "Item",
    "status": "Published",
    "sku": "TSHIRT-001",
    "stock": 100
  }'

Duplicate SKU/barcode

SKU and barcode must be unique per shop. Creating a product with a duplicate returns a 409 CONFLICT error.