Create a category

const options = {
  method: 'POST',
  headers: {
    'x-spree-api-key': '<api-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Shirts',
    parent_id: 'ctg_abc123',
    description: '<string>',
    permalink: '<string>',
    meta_title: '<string>',
    meta_description: '<string>',
    meta_keywords: '<string>',
    hide_from_nav: false
  })
};

fetch('http://{defaultHost}/api/v3/admin/categories', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request POST \
  --url http://{defaultHost}/api/v3/admin/categories \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-spree-api-key: <api-key>' \
  --data '
{
  "name": "Shirts",
  "parent_id": "ctg_abc123",
  "description": "<string>",
  "permalink": "<string>",
  "meta_title": "<string>",
  "meta_description": "<string>",
  "meta_keywords": "<string>",
  "hide_from_nav": false
}
'

{
  "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,
  "metadata": {},
  "pretty_name": "Clothing -> Shirts",
  "lft": 2,
  "rgt": 3,
  "products_count": 0,
  "created_at": "2026-07-27T20:00:06.985Z",
  "updated_at": "2026-07-27T20:00:06.991Z"
}

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