Sign in

v1

latestOpenAPI 3.1.02026-08-065163115.0 KB
Accounting Codes

Create or update an accounting code

Creates or updates a GL code for the business (upsert by code).

  • If a GL code with the given code already exists, its name is updated.
  • If a previously soft-deleted GL code with that code exists, it is restored.
  • Otherwise a new record is created.

Only available for businesses with a manual integration or no integration. If no integration exists, a manual integration is automatically created. Returns 400 if the business has a connected accounting provider (Xero, MYOB, NetSuite, QuickBooks, Business Central).

post/v1/businesses/{client_id}/accounting-codes

Path parameters

client_idinteger required
Example:123

The ID of the business.

Request body

codestring required

The GL code string. Used as the upsert key — if a code with this value already exists it will be updated.

namestring required

The display name of the GL code.

Example request

{
  "code": "4000",
  "name": "Office Expenses"
}

Response

OK (existing code updated or restored)

idstring uuid

The unique identifier for this GL code.

codestring

The GL code string used for bookkeeping export.

namestring

The display name of the GL code.

createdstring date-time

When this GL code was created in UTC.

updatedstring date-time

When this GL code was last updated in UTC.

Example response

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "code": "4000",
  "name": "Office Expenses",
  "created": "2026-01-15T10:30:00Z",
  "updated": "2026-01-15T10:30:00Z"
}