AOP API/Manual Journals

Create Manual Journal

POST/finance/journals/manual

JWT bearerPrimary write endpoint

Post a manual double-entry journal.

Endpoint

POSThttps://api.w3builders.com/v1/finance/journals/manual

Request body

description (required)
date (required, YYYY-MM-DD)
lines[] (required, minimum 2) — each: { account_id (required, must belong to your tenant), debit, credit }

Each line needs a nonzero debit OR credit — not both, not neither.
sum(debit) must equal sum(credit) within 0.01 — a 422 response tells you the exact imbalance if it doesn't.

Response parameters

Field	Type
success	value
journal_id	value

Create Manual Journal

curl -X POST https://api.w3builders.com/v1/finance/journals/manual \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "description": "Owner capital injection",
  "date": "2026-07-01",
  "lines": [
    {
      "account_id": 4,
      "debit": 50000,
      "credit": 0
    },
    {
      "account_id": 12,
      "debit": 0,
      "credit": 50000
    }
  ]
}'

{
  "success": true,
  "journal_id": 218
}

Was this page helpful?

PreviousList Manual Journals

NextDelete (Reverse) Manual Journal

Create Manual Journal

curl -X POST https://api.w3builders.com/v1/finance/journals/manual \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "description": "Owner capital injection",
  "date": "2026-07-01",
  "lines": [
    {
      "account_id": 4,
      "debit": 50000,
      "credit": 0
    },
    {
      "account_id": 12,
      "debit": 0,
      "credit": 50000
    }
  ]
}'

{
  "success": true,
  "journal_id": 218
}