finov.ioDocumentationHome

Post a manual journal

API Documentation / Resources / Journals

Posted manual journal detail with linked ledger journal and posting history
Posting creates the linked ledger journal and makes the financial entry immutable.

Post a manual journal

POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/manual-journals/{manual_journal_id}/post

Required OAuth scope: manualjournals:write

Validates and posts a balanced draft. The request has no body.

Posting checks

Check Requirement
Status The resource is still DRAFT.
Balance Signed gross line amounts total exactly 0.0000.
Accounts and tax Every referenced resource is active and valid for the journal date.
Dimensions Elements are active and valid for their dimension slots.
Accounting period The journal date is not in a locked period.

Success creates an immutable accounting journal and returns its journal_id. Retrying an already posted draft does not create a second journal and returns 409 manual_journal_posted.

Parameters

Name In Required Type Description
tenant_id path Yes string (uuid) UUID of the authorized company group.
subsidiary_id path Yes string (uuid) UUID of the subsidiary whose books contain the bank account.
manual_journal_id path Yes string (uuid) UUID of a manual journal draft.

Request

POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/manual-journals/{manual_journal_id}/post HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Content-Length: 0

Responses

Status Description
200 Manual journal posted.
401 Access token is missing, expired, revoked, or invalid.
403 Token lacks the required scope or granted accounting context.
404 Manual journal does not exist in the granted accounting context.
409 Manual journal state does not permit the requested transition.
422 Journal data, balance, references, or accounting period failed validation.

200 example

HTTP/1.1 200 OK
Content-Type: application/json

{
  "data": {
    "id": "8bbcf430-b958-4575-89fd-a7cbb17e9114",
    "date": "2026-08-31",
    "narration": "Monthly consulting accrual",
    "description": null,
    "contact_id": null,
    "external_source": "month-end",
    "external_type": null,
    "external_reference": "ACCRUAL-2026-08",
    "status": "POSTED",
    "balance": "0.0000",
    "journal_id": "ca2dc67d-02ca-429d-9d1a-42af1804a88d",
    "lines": [
      {
        "id": "d5e8ef74-f021-45d0-b4b0-778d324be162",
        "account_id": "a110c7ae-3208-4f93-a64c-d2ba9dd82c33",
        "amount": "1200.0000",
        "description": "Consulting expense",
        "tax_rate_id": null,
        "dimension_element_ids": []
      },
      {
        "id": "7f28bfee-0509-4a55-a23b-2b60576ec094",
        "account_id": "a110c7ae-3208-4f93-a64c-d2ba9dd82c34",
        "amount": "-1200.0000",
        "description": "Accrued expenses",
        "tax_rate_id": null,
        "dimension_element_ids": []
      }
    ],
    "posted_at": "2026-08-31T18:00:00Z",
    "created_at": "2026-08-10T14:00:00Z",
    "updated_at": "2026-08-31T18:00:00Z"
  }
}