v

Channels

Publish listings to storefronts and tenants.

Channels

A channel is a storefront or tenant your listings appear in. You control which listings are visible in which channel, and each channel may carry its own price.

Create a channel

curl -X POST https://api.wine2you.shop/v1/channels \
  -H "Authorization: Bearer $W2Y_KEY" -H "Content-Type: application/json" \
  -d '{"name":"My Cellar","slug":"my-cellar","currency":"CHF"}'

Publish listings

curl -X POST https://api.wine2you.shop/v1/channels/ch_.../publish \
  -H "Authorization: Bearer $W2Y_KEY" -H "Content-Type: application/json" \
  -d '{"listing_ids":["lst_...","lst_..."]}'

Storefront keys

Each channel that faces end customers gets a publishable key — safe to embed in a storefront. Server-side operations use your secret key, never in a browser.

Key Where Safe in browser?
publishable storefront ✅
secret server-side only ❌ never

Next steps

Edit this page on GitHub ↗