Create a product collection

Create a product collection. The URL handle must be unique for the merchant, and every product must belong to the merchant.

---

Related endpoints

• GET /products — List products
• POST /products — Create product
• GET /products/{id} — Get product by ID
• PATCH /products/{id} — Update product
• PUT /products/external/{source}/{externalId} — Upsert product by external ID
• PUT /products/external/batch — Batch upsert products by external ID
• GET /product-collections — List product collections
• GET /product-collections/{id} — Get a product collection

Common errors

• 403 authorization_error — the caller is identified but the action is denied. Codes include insufficient_permissions, ip_not_allowed, merchant_mismatch, and origin_not_allowed.
• 409 conflict — Idempotency-Key collision with a different body, or a concurrent state-transition conflict.
• 422 unprocessable_entity — business-rule failure (for example, refunding more than the original charge).

Idempotency

Pass an Idempotency-Key header (UUID v4 recommended) to make retries safe. Keys are valid for 24 hours; see the idempotency guide.

Response Body

curl -X POST "https://api.revkeen.com/v2/product-collections" \
  -H "x-api-key: $REVKEEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "example",
    "slug": "example"
  }'

{  "data": {    "id": "00000000-0000-4000-8000-000000000001",    "object": "product_collection",    "name": "Example customer",    "slug": "string",    "description": "string",    "image_asset_id": "string",    "position": 0,    "version": 0,    "product_ids": [      "string"    ],    "created_at": "2026-09-01T12:00:00Z",    "updated_at": "2026-09-01T12:00:00Z"  }}