Practice Manager API

Journal Entries

Journal entries are manual double-entry postings to the general ledger. Each posting has a memo, date, optional reference number, and balanced debit/credit lines that reference chart-of-accounts UUIDs.

Last updated 2026-11-18

Overview

The Journal Entries API lets your integration list, read, create, bulk-create, update, and delete manual journal postings in a workspace. Each posting must balance: every line carries exactly one of `amountDebit` or `amountCredit`, never both and never neither.

Partner mutation bodies use `accountUuid` on each line (the `id` from chart of accounts). System-generated entries from invoices, bills, payroll, and other integrations are read-only — update and delete return 400 for those sources.

Key concepts

Balance checks

Each line requires `accountUuid` plus exactly one of `amountDebit` or `amountCredit`. Create and bulk create accept a posting whose debits do not equal its credits, for period-close accruals, payroll clearing and imports, so check balance yourself if you need it. Update rejects an unbalanced `lines` array with 400. Postings COUNT builds for bills, invoices and transactions are always balanced.

Account UUID resolution

Copy account UUIDs from chart of accounts (`id`, `accUuid`, or `accountUuid` fields — any UUID-shaped value from list accounts works). Do not pass numeric internal account ids.

Manual entries only

Only manually-created entries (and Square integration entries) can be updated or deleted. System-generated entries return 400.

Bulk partial success

Bulk create processes up to 100 postings independently. Response: `{ successCount, errorCount, results: [{ index, success, journalEntry? | error? }] }` with HTTP 201 even when some rows fail.

The journal entry line object

List and mutation responses return an array of lines sharing the same `journalLinkUuid`. Each line represents one debit or credit leg.

Attributes

iduuid

Line identifier (UUID). Pass in the path to update or delete the posting group anchor line.

descriptionEntrystring

Posting memo shared across all lines in the entry.

descriptionLinestring

Optional per-line description.

datedate

Posting date (ISO YYYY-MM-DD).

refNumberstring

Optional reference number.

amountDebitstring

Debit amount as a decimal string, or null when this line is a credit.

amountCreditstring

Credit amount as a decimal string, or null when this line is a debit.

accountUuiduuid

Chart-of-accounts UUID for this line.

accountobject

Embedded account summary when included on list responses.

journalLinkUuiduuid

Shared link id grouping all lines in the same posting.

createdAtdatetime

ISO 8601 creation timestamp.

updatedAtdatetime

ISO 8601 last update timestamp.

Example
{
  "id": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
  "descriptionEntry": "Accrue March rent",
  "descriptionLine": "Rent expense",
  "date": "2026-03-01",
  "refNumber": "JE-2026-003",
  "amountDebit": "2500.00",
  "amountCredit": null,
  "accountUuid": "c8d9e0f1-a2b3-4567-cdef-789012345678",
  "account": {
    "id": "c8d9e0f1-a2b3-4567-cdef-789012345678",
    "name": "Rent Expense",
    "type": "Expenses"
  },
  "journalLinkUuid": "a9b8c7d6-e5f4-3210-abcd-ef9876543210",
  "createdAt": "2026-01-15T10:30:00.000Z",
  "updatedAt": "2026-01-28T14:22:30.000Z"
}

withCaution bypasses period checks

Pass `withCaution: true` on create (sparingly) to skip book-closeness checks. Manual entries can still fail when a line posts into a reconciled period for that account.

Bulk performance

Bulk create resolves all account UUIDs in a single batched lookup across the whole batch — prefer bulk over repeated single creates for large imports (~25 postings per batch recommended).

Update replaces all lines

PATCH sends the full replacement `lines` array with the same shape as create. Partial line patches are not supported.

Three ways to send a file

JSON `attachments` entries take a public `url` (COUNT downloads and keeps a copy) or the file inline as `contentBase64` (up to 10 MB). The `/upload` routes take `multipart/form-data`. All three are held to the same per-file cap and file types, at most 10 files a request, and every file is virus-scanned before anything is saved. To read a file back without following a link, call the attachment's `/content` route, which returns it base64-encoded.

File links are signed per response

Any `documentUrl`, `receiptUrl`, `pdfUrl` or `bankStatementUrl` on COUNT storage comes back as a short-lived signed link, minted only after COUNT proves the file belongs to this workspace. Use it straight away and call again for a fresh one; do not store it. A file COUNT cannot prove is the workspace's comes back as `null`. A link you attached to an outside file is returned exactly as you sent it.

Endpoints

GET
List journal entries/firm-partners/workspace/journal-entries

Returns a paginated list of journal entry lines.

GET
Get a journal entry/firm-partners/workspace/journal-entries/{uuid}

Returns one posting with every line, in entry order.

POST
Create journal entry/firm-partners/workspace/journal-entries

Creates a manual journal entry posting.

POST
Bulk create journal entries/firm-partners/workspace/journal-entries/bulk

Creates up to 100 journal entry postings in one request with partial-success semantics.

PATCH
Update journal entry/firm-partners/workspace/journal-entries/{uuid}

Updates a manually-created journal entry by UUID.

DELETE
Delete journal entry/firm-partners/workspace/journal-entries/{uuid}

Deletes a journal entry posting by UUID.

GET
List journal entry attachments/firm-partners/workspace/journal-entries/{uuid}/attachments

Lists the files attached to a manual journal entry.

POST
Add journal entry attachments/firm-partners/workspace/journal-entries/{uuid}/attachments

Adds files to a manual journal entry from public URLs or inline base64 content.

POST
Upload journal entry attachments/firm-partners/workspace/journal-entries/{uuid}/attachments/upload

Adds files to a manual journal entry via multipart form data.

DELETE
Delete journal entry attachment/firm-partners/workspace/journal-entries/{uuid}/attachments/{attachmentUuid}

Removes one attachment from a manual journal entry.

GET
Get journal entry attachment content/firm-partners/workspace/journal-entries/{uuid}/attachments/{attachmentUuid}/content

Returns a journal entry attachment's file, base64-encoded, with its note.