---
title: "Add an item category"
method: POST
path: "/item_categories"
tags: ["Item Categories"]
---

# Add an item category

`POST /item_categories`

 

## Request body

- object
  - `item_category_name` string, required — Give the item category a name.
  - `item_category_description` string — Add a description for the item category.
  - `item_category_image` string — Base64 Encoded.
  - `item_category_thumbnail` string — Base64 Encoded.
  - `item_category_tag` string — If tag does not exist, they will be created. For multiples, separate by ,
  - `item_category_notes` string — Apply note to the history of this item category.

## Response `200`

OK

- object
  - `item_category_id` integer
  - `item_category_slug` string, nullable
  - `item_category_name` string
  - `item_category_description` string, nullable
  - `item_category_image` string, nullable
  - `item_category_thumbnail` string, nullable
  - `date_created` string, date-time
  - `created_by` integer
  - `date_modified` string, date-time
  - `modified_by` integer
  - `item_category_notes` string, nullable
  - `item_category_tags` object[], nullable
    - `tag_id` integer
    - `tag_name` string
    - `tag_slug` string
    - `tag_image` string, nullable

## Other responses

- `400` — Error response
- `401` — Unauthorized response
- `403` — Forbidden response
- `500` — Error response

---

[API](https://skmtc.net/vrio/apis/crm-configuration.md) · [All operations](https://skmtc.net/vrio/apis/crm-configuration/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vrio/crm-configuration/revisions/62037010356e/schema)