Create category

Use this endpoint to create a single category

post

https://dev.lunchmoney.app/v1/categories
Request
Response
Request
Body Parameters
name
required
string
Name of category. Must be between 1 and 40 characters.
description
optional
string
Description of category. Must be less than 140 categories.
is_income
optional
boolean
Whether or not transactions in this category should be treated as income. Defaults to false.
exclude_from_budget
optional
boolean
Whether or not transactions in this category should be excluded from budgets. Defaults to false.
exclude_from_totals
optional
boolean
Whether or not transactions in this category should be excluded from calculated totals. Defaults to false.
Response
200: OK
Returns the ID of the newly-created category
{
"category_id": 26213
}
400: Bad Request
{ error: 'Missing category name.' }
{ error: 'Category name must be less than 40 characters.' }
{ error: 'Category description must be less than 140 characters.' }
{ error: 'Operation error occurred. Please try again or contact support@lunchmoney.app for assistance.' }