Your first product

Two ways: CLI or API. Use whichever feels familiar.

CLI

zephyr products create \
  --name "Filter coffee, 250g" \
  --sku coffee-250 \
  --price-cents 1490 \
  --currency EUR \
  --inventory 200

Output:

{
  "id": "prod_01HXY4M9C0AVE0M1QGPS9XK7T2",
  "name": "Filter coffee, 250g",
  "sku": "coffee-250",
  "default_price_cents": 1490,
  "currency": "EUR",
  "inventory": 200,
  "status": "active",
  "created_at": "2026-05-31T09:14:12Z"
}

API

The same call over HTTP:

curl -sS https://api.zephyrcart.io/v1/products \
  -H "Authorization: Bearer $ZEPHYR_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Filter coffee, 250g",
    "sku": "coffee-250",
    "default_price_cents": 1490,
    "currency": "EUR",
    "inventory": 200
  }'

The Idempotency-Key is optional but recommended. Identical retries within 24 hours return the same response without creating a duplicate product. See the Idempotency reference.

Verify in the dashboard

The product should appear in Catalog → Products within ~1 second. If it doesn't, you're probably authenticated against a different tenant — check zephyr config get tenant.

Next: Run a checkout end to end.