import { createAdminClient } from '@spree/admin-sdk'

const client = createAdminClient({
  baseUrl: 'https://your-store.com',
  secretKey: 'sk_xxx',
})

// An automatic collection: its products are the ones matching the rules.
const collection = await client.collections.create({
  name: 'On Sale',
  automatic: true,
  rules_match_policy: 'any',
  rules: [{ type: 'tag', value: 'summer', match_policy: 'contains' }],
})

spree api post /collections -d '{"name":"On Sale","automatic":true,"rules_match_policy":"any","rules":[{"type":"tag","value":"summer","match_policy":"contains"}]}'

{
  "id": "coll_gbHJdmfrXB",
  "name": "On Sale",
  "permalink": "on-sale",
  "position": 2,
  "sort_order": "manual",
  "meta_title": null,
  "meta_description": null,
  "meta_keywords": null,
  "products_count": 0,
  "description": "",
  "description_html": "",
  "image_url": null,
  "square_image_url": null,
  "automatic": true,
  "rules_match_policy": "any",
  "metadata": {},
  "created_at": "2026-01-15T12:00:00.000Z",
  "updated_at": "2026-01-15T12:00:00.000Z"
}

{
  "error": {
    "code": "validation_error",
    "message": "Name can't be blank",
    "details": {
      "name": [
        {
          "code": "blank",
          "message": "can't be blank",
          "specific": false
        }
      ]
    }
  }
}