> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fyvel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Manual entries

> Read manual entries per company, create areas, and add, change, or remove bookings.

# Manual entries

These tools work with **manual entries** in Fyvel. They read and change bookings you maintain manually, not the originally imported accounting files.

## Available tools

* `list_manual_uploads` — available areas for manual entries of a company
* `create_manual_upload` — create a new area for manual entries (matches "New group" on the Manual entries page)
* `list_manual_transactions` — bookings in an area (`uploadUuid`)
* `append_manual_transactions` — add new bookings
* `patch_manual_transactions` — change existing bookings
* `remove_manual_transactions` — remove bookings

## Areas (uploads)

Manual entries are grouped in **areas** — the same groups as in the web app under Manual entries (for example one area per month or topic). Each area has an `uploadUuid`. With `create_manual_upload` you create an empty area. With `list_manual_uploads` you list existing areas.

## Scope

Manual entries are **company-specific**. Always pass a `companyUuid` from [`list_companies`](/en/mcp/companies). For every call except `list_manual_uploads` and `create_manual_upload` you also need an `uploadUuid` from `list_manual_uploads` or from the response of `create_manual_upload`.

## Important notes

* Write tools change only the manual booking layer in Fyvel.
* When you change data, send only the rows you want to add, change, or remove.
* Each new row in `append_manual_transactions` must have exactly one of `amountDebit` or `amountCredit` greater than zero.
* The organisation comes from the MCP bearer token.

## Typical flow

**New area with bookings:**

1. `list_companies`
2. `create_manual_upload` with `companyUuid` and `name` → `uploadUuid` from the response
3. `append_manual_transactions` with `companyUuid`, `uploadUuid`, and the new rows

**Existing area:**

1. `list_companies`
2. `list_manual_uploads` with `companyUuid`
3. choose the `uploadUuid` you want
4. `list_manual_transactions` to read, or a mutation (`append_*`, `patch_*`, `remove_*`)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.