Skip to main content
POST
/
v1
/
categories
Create a Category
curl --request POST \
  --url https://api.bookeeping.ai/public-api/v1/categories \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "parentCategory": "INCOME",
  "number": "",
  "emoji": "<string>",
  "group": "<string>"
}
'
{
  "message": "<string>",
  "metaData": {
    "warnings": [
      "<string>"
    ]
  },
  "data": {
    "_id": "<string>",
    "name": "<string>",
    "projectId": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "emoji": "<string>",
    "parentCategory": "INCOME",
    "isArchived": true,
    "number": "<string>",
    "group": "<string>",
    "createdBy": "USER"
  }
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Get your key from the Dashboard > Settings > API Access.

Body

application/json
​
name
string
required

The name of the category

​
parentCategory
enum<string>
required

The parent category of the category

Available options:
INCOME,
OTHER_INCOME,
SALES,
EXPENSE,
DEPRECIATION,
COST_OF_GOODS_SOLD,
OTHER_EXPENSE,
OVERHEAD,
CURRENT_ASSET,
FIXED_ASSET,
INVENTORY,
NON_CURRENT_ASSET,
PREPAYMENT,
LIABILITY,
CURRENT_LIABILITY,
NON_CURRENT_LIABILITY,
TAX_PAYABLE,
TAX,
EQUITY,
OTHER
​
number
string
default:""
required

The number of the category

​
emoji
string | null
​
group
string | null

Response

Create a Category executed successfully

​
message
string

Success message

​
metaData
object
​
data
object