---
title: "Create Journal Entry"
method: POST
path: "/api/businesses/{business_id}/workbook/journal-entries"
tags: ["Data Cleaning"]
---

# Create Journal Entry

`POST /api/businesses/{business_id}/workbook/journal-entries`

## Request

- Base URL: `https://api.flagpost.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.flagpost.ai/api/businesses/{business_id}/workbook/journal-entries`
- Auth: HTTP bearer

## Path parameters

- `business_id` string, required

## Request body

- JournalEntryCreate: Create a new journal entry with 2..n lines.
  - `memo` string, nullable
  - `period_key` string, required
  - `status` 'draft' | 'applied': Status of a journal entry. Only ``applied`` affects balances.
  - `entry_no` string, nullable
  - `lines` JournalEntryLineInput[], required
    - `id` string, uuid, nullable
    - `account_id` string, uuid, nullable
    - `entity_id` string, uuid, nullable
    - `amount` number, required
    - `sort_order` integer, nullable
    - `raw_label` string, nullable

## Response `200`

Successful Response

- JournalEntryModel: Full journal entry payload returned to the UI.
  - `id` string, uuid, required
  - `business_id` string, uuid, required
  - `advisory_id` string, uuid, required
  - `databook_id` string, uuid, required
  - `memo` string, nullable
  - `period_key` string, required
  - `status` 'draft' | 'applied': Status of a journal entry. Only ``applied`` affects balances.
  - `origin` 'manual' | 'extracted': How the entry entered the ledger.
  - `entry_no` string, nullable
  - `source_document_id` string, uuid, nullable
  - `source_meta` object
  - `version` integer
  - `lines` JournalEntryLineModel[]
    - `id` string, uuid, required
    - `account_id` string, uuid, nullable
    - `entity_id` string, uuid, nullable
    - `amount` number, required
    - `sort_order` integer
    - `raw_label` string, nullable
  - `created_by` string, uuid, nullable
  - `created_at` string, nullable
  - `updated_at` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/flagpost/apis/flagpost-api.md) - [All operations](https://skmtc.dev/flagpost/apis/flagpost-api/llms.txt) - [OpenAPI document](https://skmtc.dev/flagpost/apis/flagpost-api/revisions/0308cef485ca?raw)