---
title: "Adds a Project Category"
method: POST
path: "/ProjectCategories"
tags: ["ProjectCategories"]
---

# Adds a Project Category

`POST /ProjectCategories`

## Request

- Base URL: `https://api.insightly.com/v3.1`
- URL: `https://api.insightly.com/v3.1/ProjectCategories`
- Auth: none declared. Required headers: `Authorization`

This endpoint is used to create a new project category. This endpoint is only accessible to users with administrator permission.

## Headers

- `Authorization` string, required

## Request body

- APICategory
  - `CATEGORY_ID` integer
  - `CATEGORY_NAME` string, required
  - `ACTIVE` boolean
  - `BACKGROUND_COLOR` string, required

## Response `201`

Project Category added.

- object
  - `CATEGORY_ID` integer
  - `CATEGORY_NAME` string, required
  - `ACTIVE` boolean
  - `BACKGROUND_COLOR` string, required

## Other responses

- `400`: Data validation error.
- `401`: Authentication failed.
- `403`: API User does not have permission to add Project Categories.

---

[API](https://skmtc.dev/insightly/apis/insightly-api-v3-1.md) - [All operations](https://skmtc.dev/insightly/apis/insightly-api-v3-1/llms.txt) - [OpenAPI document](https://skmtc.dev/insightly/apis/insightly-api-v3-1/revisions/e7df0c3b65fb?raw)
