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

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

const category = await client.categories.create({
  name: 'Shirts',
  parent_id: 'ctg_UkLWZg9DAJ',
  description: '<p>Casual and dress shirts.</p>',
})

spree api post /categories -d '{"name":"Shirts","parent_id":"ctg_UkLWZg9DAJ","description":"<p>Casual and dress shirts.</p>"}'

{
  "id": "ctg_gbHJdmfrXB",
  "name": "Shirts",
  "permalink": "clothing/shirts",
  "position": 0,
  "depth": 1,
  "meta_title": null,
  "meta_description": null,
  "meta_keywords": null,
  "children_count": 0,
  "parent_id": "ctg_UkLWZg9DAJ",
  "description": "",
  "description_html": "",
  "image_url": null,
  "square_image_url": null,
  "is_root": false,
  "is_child": true,
  "is_leaf": true,
  "external_references": {},
  "metadata": {},
  "pretty_name": "Clothing -> Shirts",
  "lft": 2,
  "rgt": 3,
  "products_count": 0,
  "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
        }
      ]
    }
  }
}