API OverviewAPI EndpointsCategories

Create a new category

Create a new transaction category (Chart of Accounts entry) for an entity. This creates the category in both the TigerBeetle ledger system and the local database.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

entityIdstringRequired
The ID of the entity to create the category for

Request

This endpoint expects an object.
namestringRequired
Name of the category
typeenumRequired
Account type for the category
Allowed values:
financialTypestringOptional

More specific financial classification (optional - will be auto-determined if not provided)

accountCodeintegerOptional

Account code for organization (optional - will be auto-assigned if not provided)

subTypeCodeintegerOptional

Sub-type code for detailed classification (optional - will be auto-assigned if not provided)

Response

Category created successfully
categoryobject or null
messagestring or null