Category & subcategory

Create parent category and subcategories

Creates a new parent category, then one or more child categories with parentId set to that parent. Scoped to the API key company.

post/v1/workflows/category/parent-with-subcategory

Request

  • Base URL: https://api.finalpos.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.finalpos.com/v1/workflows/category/parent-with-subcategory
  • Auth: API key in header x-api-key

Request body

Example request

{
  "parentCategory": {
    "externalId": "1234567890",
    "name": "Beverages",
    "description": "Beverages are drinks that are not alcoholic.",
    "image": "https://example.com/image.jpg",
    "parentId": "o1p2q3r4s5t6u7v8w9x0y1z2",
    "menuOrder": 1,
    "source": "manual"
  },
  "subCategories": [
    {
      "externalId": "1234567890",
      "name": "Beverages",
      "description": "Beverages are drinks that are not alcoholic.",
      "image": "https://example.com/image.jpg",
      "parentId": "o1p2q3r4s5t6u7v8w9x0y1z2",
      "menuOrder": 1,
      "source": "manual"
    }
  ]
}

Response

Creates a parent category and one or more subcategories with parentId set to the new parent, scoped to the API key company.

Example response

{
  "parentCategory": {
    "id": "o1p2q3r4s5t6u7v8w9x0y1z2",
    "createdAt": "2025-12-07T19:31:48.436+00:00",
    "updatedAt": "2025-12-07T19:35:48.436+00:00",
    "companyId": "o1p2q3r4s5t6u7v8w9x0y1z2",
    "externalId": "1234567890",
    "name": "Beverages",
    "description": "Beverages are drinks that are not alcoholic.",
    "image": "https://example.com/image.jpg",
    "parentId": "o1p2q3r4s5t6u7v8w9x0y1z2",
    "menuOrder": 1,
    "source": "manual"
  },
  "subCategories": [
    {
      "id": "o1p2q3r4s5t6u7v8w9x0y1z2",
      "createdAt": "2025-12-07T19:31:48.436+00:00",
      "updatedAt": "2025-12-07T19:35:48.436+00:00",
      "companyId": "o1p2q3r4s5t6u7v8w9x0y1z2",
      "externalId": "1234567890",
      "name": "Beverages",
      "description": "Beverages are drinks that are not alcoholic.",
      "image": "https://example.com/image.jpg",
      "parentId": "o1p2q3r4s5t6u7v8w9x0y1z2",
      "menuOrder": 1,
      "source": "manual"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.