Basic information

POST /{shopId}/categories/{categoryId}

Creates a subcategory to an existing category. Providing attributes in the request is optional.

Authorisation

OAuth 2.0 Token required with scopes:

products_write

URI parameters

Name Type Description
shopId string

The unique identifier of the shop.

Required: true
Example: DemoShop
categoryId string
Required: true

Query parameters

Name Type Description
locale string

Represents the language code according to ISO 639-1 and the country code according to ISO 3166-1. If not provided, the shop’s default language is used. We recommend to always send this parameter with your request. If the default language had been changed in the administration, it might take up to 1 day until this change affects the shop.

Required: false
Example: en_US

Request attributes

Name Type Description

object of category (create request)

Request body

Media type application/json

{
  "name": "Accessories",
  "alias": "Accessories",
  "pageTitle": "Technic365 - Accessories",
  "description": "Accessories for headphones",
  "navigationCaption": "Technic365 - Accessories"
}

Response attributes

Name Type Description

object of subcategory

Response

HTTP 200

Media type application/json

{
  "categoryId": "5742CDAC-4EC6-859E-15D4-D5809AB3AC2E",
  "alias": "Accessories",
  "name": "Accessories",
  "visible": false,
  "visibleInNavigation": true,
  "pageTitle": "Technic365 - Accessories",
  "navigationCaption": "Technic365 - Accessories",
  "description": "Accessories for headphones",
  "facetedSearchShowFacetsOnCategory": true ,
  "facetedSearchCategoryStartDepth": 3,
  "parent": {
    "rel": "parent",
    "href": "https://pm.epages.com/rs/shops/apidocu/categories/5171DD85-C092-46EB-2BEC-AC14145F9094",
    "title": "Categories"
  },
  "sfUrl": "http://pm.epages.com/epages/apidocu.sf/?ObjectPath=/Shops/apidocu/Categories/Accessories1",
  "links": [
    {
      "rel": "products",
      "href": "https://pm.epages.com/rs/shops/apidocu/products?categoryId=5742CDAC-4EC6-859E-15D4-D5809AB3AC2E"
    }
  ]
}