---
title: "Adds a Knowledge Article Folder"
method: POST
path: "/KnowledgeArticleFolder"
tags: ["KnowledgeArticleFolders"]
---

# Adds a Knowledge Article Folder

`POST /KnowledgeArticleFolder`

## Request

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

If you have trouble with creating a Knowledge Article Folder, try creating Knowledge Article Folders via the web interface, and then access those Knowledge Article Folders via the API. This way you            can see examples of the fields and sub-elements attached to the Knowledge Article Folder. A common source of problems during write/update request is caused when users omit            required fields, or insert invalid data in a field (e.g. reference a CATEGORY_ID that does not exist in the user's Insightly instance.

## Headers

- `Authorization` string, required

## Request body

- object
  - `FOLDER_ID` integer
  - `FOLDER_NAME` string, string, required
  - `CATEGORY_ID` string, string, required
  - `VISIBILITY` string, string
  - `ORDER_ARTICLES` string, string

## Response `201`

Request succeeded.

- object
  - `FOLDER_ID` integer
  - `FOLDER_NAME` string, string, required
  - `CATEGORY_ID` string, string, required
  - `VISIBILITY` string, string
  - `ORDER_ARTICLES` string, string
  - `CREATED_USER_ID` integer
  - `DATE_CREATED_UTC` string, date-time
  - `DATE_UPDATED_UTC` string, date-time

## Other responses

- `400`: Data validation error.
- `401`: Authentication failed.
- `402`: Record limit reached.

---

[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)