> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Money Forward

> Access Money Forward business tenant details and Cloud Accounting offices, master data, journals, trade partners, and financial reports.

![Money Forward logo](https://mintcdn.com/composio-preview/9YPuzjEU4UlMnwGq/images/toolkits/money_forward.svg?fit=max\&auto=format\&n=9YPuzjEU4UlMnwGq\&q=85\&s=010c7c2a28398f0873d8d88bf6329a04)

* **Category:** accounting
* **Auth:** OAUTH2
* **Composio-managed OAuth available?** No
* **Tools:** 23
* **Triggers:** 0
* **Slug:** `MONEY_FORWARD`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Journal
>
> **Slug:** `MONEY_FORWARD_CREATE_JOURNAL`
>
> Create and persist an accounting journal with one to 300 debit and credit lines. This action changes the connected Cloud Accounting ledger. On create, Money Forward appends a newline and the OAuth application name to memo; leave room within the 200-character input limit and trust the returned memo as the persisted value.
>
> #### Input Parameters
>
> **journal** `object` *required*
>
> Journal data to create or replace.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Trade Partners
>
> **Slug:** `MONEY_FORWARD_CREATE_TRADE_PARTNERS`
>
> Create and persist one or more Cloud Accounting trade-partner master records in one batch. A successful call has a persistent side effect; the approved API surface provides no operation to update or delete these records.
>
> #### Input Parameters
>
> **trade\_partners** `array` *required*
>
> Trade-partner master records to create in one batch request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Transactions
>
> **Slug:** `MONEY_FORWARD_CREATE_TRANSACTIONS`
>
> Create and persist a batch of one to 1,000 manual transactions under one Money Forward connected service. New transactions can take a short time to appear in filtered transaction lists.
>
> #### Input Parameters
>
> **transactions** `array` *required*
>
> Transactions to create in one provider batch (1-1000 items).
>
> **connected\_account\_id** `string` *required*
>
> ID of the connected service under which to create the transactions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Vouchers
>
> **Slug:** `MONEY_FORWARD_CREATE_VOUCHERS`
>
> Persist one to five base64-encoded voucher files in Money Forward Cloud Accounting and optionally attach them to a journal. A successful call stores the uploaded evidence; the documented vouchers API can detach a voucher from a journal but does not provide an operation to delete the stored file.
>
> #### Input Parameters
>
> **journal\_id** `string`
>
> Journal ID to attach the new vouchers to; omit to store them unattached.
>
> **voucher\_files** `array` *required*
>
> Voucher files to persist in this provider batch (1-5 files).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Journal
>
> **Slug:** `MONEY_FORWARD_DELETE_JOURNAL`
>
> Permanently delete one Money Forward Cloud Accounting journal by ID. Back up the journal before deletion; if it is linked to a transaction, that transaction becomes excluded.
>
> #### Input Parameters
>
> **journal\_id** `string` *required*
>
> ID of the journal to permanently delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Detach Voucher From Journal
>
> **Slug:** `MONEY_FORWARD_DETACH_VOUCHER_FROM_JOURNAL`
>
> Remove the association between one Money Forward voucher and one journal. This irreversible update does not delete the stored voucher file.
>
> #### Input Parameters
>
> **journal\_id** `string` *required*
>
> Journal ID currently associated with the voucher.
>
> **voucher\_file\_id** `string` *required*
>
> Voucher file ID whose association with the journal will be removed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Account Balance Trends
>
> **Slug:** `MONEY_FORWARD_GET_ACCOUNT_BALANCE_TRENDS`
>
> Return monthly balance-sheet or profit-and-loss trends for a fiscal period; the report excludes unrealized journals and aggregates all departments.
>
> #### Input Parameters
>
> **end\_month** `integer`
>
> Ending month within fiscal\_year; omit to use the fiscal-year end month.
>
> **statement** `string ("balance_sheet" | "profit_and_loss")` *required*
>
> Financial statement whose monthly trends to return.
>
> **fiscal\_year** `integer`
>
> Accounting fiscal year; omit to use the latest fiscal year.
>
> **include\_tax** `boolean`
>
> Calculate tax-inclusive amounts where the office's accounting method supports this option; otherwise the provider ignores it.
>
> **start\_month** `integer`
>
> Starting month within fiscal\_year; omit to use the fiscal-year start month.
>
> **with\_sub\_accounts** `boolean`
>
> Include amounts broken down by sub-account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Journal
>
> **Slug:** `MONEY_FORWARD_GET_JOURNAL`
>
> Return one accounting journal by its journal ID, including debit and credit branches and attached voucher IDs.
>
> #### Input Parameters
>
> **journal\_id** `string` *required*
>
> Journal ID returned by LIST\_JOURNALS.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Accounting Office
>
> **Slug:** `MONEY_FORWARD_GET_OFFICE`
>
> Return the connected Cloud Accounting office and its accounting periods; fails if the tenant is not registered for Cloud Accounting.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Tenant
>
> **Slug:** `MONEY_FORWARD_GET_TENANT`
>
> Return the code and name of the Money Forward business tenant authorized by the connected account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Trial Balance
>
> **Slug:** `MONEY_FORWARD_GET_TRIAL_BALANCE`
>
> Return a balance-sheet or profit-and-loss trial balance for a fiscal period; the report excludes unrealized journals and aggregates all departments.
>
> #### Input Parameters
>
> **end\_date** `string`
>
> Optional report end date in YYYY-MM-DD format.
>
> **end\_month** `integer`
>
> Ending month within fiscal\_year; omit to use the fiscal-year end month.
>
> **statement** `string ("balance_sheet" | "profit_and_loss")` *required*
>
> Financial statement to return.
>
> **start\_date** `string`
>
> Optional report start date in YYYY-MM-DD format.
>
> **fiscal\_year** `integer`
>
> Accounting fiscal year; omit to use the latest fiscal year.
>
> **include\_tax** `boolean`
>
> Calculate tax-inclusive amounts where the office's accounting method supports this option; otherwise the provider ignores it.
>
> **start\_month** `integer`
>
> Starting month within fiscal\_year; omit to use the fiscal-year start month.
>
> **journal\_types** `array`
>
> Journal types to include; include adjusting\_entry when closing adjustments are needed.
>
> **with\_sub\_accounts** `boolean`
>
> Include amounts broken down by sub-account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Journalize Transaction
>
> **Slug:** `MONEY_FORWARD_JOURNALIZE_TRANSACTION`
>
> Create and persist a journal from one Money Forward transaction using the supplied account classification. This compound operation also irreversibly changes the source transaction's journalizing state.
>
> #### Input Parameters
>
> **memo** `string`
>
> Optional journal memo of at most 200 characters.
>
> **tags** `array`
>
> Optional journal tags; each tag may contain at most 20 characters.
>
> **remark** `string`
>
> Optional journal-line remark of at most 200 characters.
>
> **tax\_id** `string`
>
> Optional tax-category ID.
>
> **account\_id** `string` *required*
>
> Account ID used to classify the transaction.
>
> **invoice\_kind** `string ("INVOICE_KIND_NOT_TARGET" | "INVOICE_KIND_QUALIFIED" | "INVOICE_KIND_UNQUALIFIED_80" | "INVOICE_KIND_UNQUALIFIED_70" | "INVOICE_KIND_UNQUALIFIED_50" | "INVOICE_KIND_UNQUALIFIED_30" | "INVOICE_KIND_UNQUALIFIED")`
>
> Optional qualified-invoice classification.
>
> **department\_id** `string`
>
> Optional department ID.
>
> **sub\_account\_id** `string`
>
> Optional sub-account ID.
>
> **transaction\_id** `string` *required*
>
> ID of the transaction to journalize.
>
> **transaction\_date** `string`
>
> Optional journal transaction date in YYYY-MM-DD format; Money Forward uses the source transaction date when omitted.
>
> **trade\_partner\_code** `string`
>
> Optional trade-partner code.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Accessible Accounting Offices
>
> **Slug:** `MONEY_FORWARD_LIST_ACCESSIBLE_OFFICES`
>
> List every Cloud Accounting office available to the current authorization; offices that cannot use Cloud Accounting are excluded.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Accounts
>
> **Slug:** `MONEY_FORWARD_LIST_ACCOUNTS`
>
> List Cloud Accounting chart-of-account entries and their IDs for use in journals and reports.
>
> #### Input Parameters
>
> **available** `boolean`
>
> Filter by availability; omit to use the provider's unfiltered behavior.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Connected Accounts
>
> **Slug:** `MONEY_FORWARD_LIST_CONNECTED_ACCOUNTS`
>
> List external financial services connected to the current Cloud Accounting office, including manual status and linked account and sub-account IDs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Departments
>
> **Slug:** `MONEY_FORWARD_LIST_DEPARTMENTS`
>
> List Cloud Accounting departments and their IDs for interpreting or constructing journal lines.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Journals
>
> **Slug:** `MONEY_FORWARD_LIST_JOURNALS`
>
> Return one page of accounting journals for a transaction-date period, requiring at least a start or end date. Optionally filter by account, transaction IDs, or realization status; use the returned total\_pages to continue through results.
>
> #### Input Parameters
>
> **page** `integer`
>
> Provider page number to return, starting at 1.
>
> **end\_date** `string`
>
> Inclusive transaction-date end in YYYY-MM-DD format; provide this or start\_date.
>
> **per\_page** `integer`
>
> Maximum journals in this page (1-10000).
>
> **account\_id** `string`
>
> Return journals having this account on either the debit or credit side.
>
> **start\_date** `string`
>
> Inclusive transaction-date start in YYYY-MM-DD format; provide this or end\_date.
>
> **is\_realized** `boolean`
>
> Filter by realization status; omit to include all journals.
>
> **transaction\_ids** `array`
>
> Transaction IDs whose linked journals to return (up to 50).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Sub-Accounts
>
> **Slug:** `MONEY_FORWARD_LIST_SUB_ACCOUNTS`
>
> List Cloud Accounting sub-accounts, optionally limited to one parent account, and return their IDs and tax mappings.
>
> #### Input Parameters
>
> **account\_id** `string`
>
> Parent account ID to filter by; omit to list sub-accounts across accounts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Tax Categories
>
> **Slug:** `MONEY_FORWARD_LIST_TAXES`
>
> List Cloud Accounting tax categories, rates, availability, and IDs used on journal lines.
>
> #### Input Parameters
>
> **available** `boolean`
>
> Filter by availability; omit to use the provider's unfiltered behavior.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Term Settings
>
> **Slug:** `MONEY_FORWARD_LIST_TERM_SETTINGS`
>
> Return all accounting-year settings for the connected Cloud Accounting office, ordered by descending start date.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Trade Partners
>
> **Slug:** `MONEY_FORWARD_LIST_TRADE_PARTNERS`
>
> List Cloud Accounting trade partners and their codes, registration numbers, and availability for use on journal lines.
>
> #### Input Parameters
>
> **available** `boolean`
>
> Filter by availability; omit to use the provider's unfiltered behavior.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Transactions
>
> **Slug:** `MONEY_FORWARD_LIST_TRANSACTIONS`
>
> Return one page of collected transaction details for an inclusive date range no more than 366 days apart, with connected-account, amount, text, journalization-status, and ordering filters. Use page and returned total\_pages to continue; newly created transactions can take a short time to appear in filtered lists.
>
> #### Input Parameters
>
> **page** `integer`
>
> Provider page number to return, starting at 1.
>
> **side** `string ("INCOME" | "EXPENSE")`
>
> Filter transactions by income or expense side; required with an amount filter.
>
> **order** `string ("asc" | "desc")`
>
> Transaction-date sort order.
>
> **content** `string`
>
> Transaction-content text to match.
>
> **end\_date** `string` *required*
>
> Inclusive transaction-date end, at most 366 days after start\_date.
>
> **per\_page** `integer`
>
> Maximum transactions in this page (10-500).
>
> **value\_max** `integer`
>
> Maximum transaction amount (0-999999999999); requires side.
>
> **value\_min** `integer`
>
> Minimum transaction amount (0-999999999999); requires side.
>
> **start\_date** `string` *required*
>
> Inclusive transaction-date start in YYYY-MM-DD format.
>
> **content\_match\_type** `string ("exact" | "partial" | "forward" | "backward")`
>
> How content is matched; the provider ignores this when content is omitted.
>
> **connected\_account\_id** `string`
>
> Connected service ID; cannot be combined with connected\_sub\_account\_id.
>
> **journalizing\_statuses** `array`
>
> Journalization statuses to include.
>
> **connected\_sub\_account\_id** `string`
>
> Connected sub-account ID; cannot be combined with connected\_account\_id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Journal
>
> **Slug:** `MONEY_FORWARD_UPDATE_JOURNAL`
>
> Replace an existing accounting journal's writable fields. This is a full replacement: writable fields omitted from the journal body are overwritten rather than preserved.
>
> #### Input Parameters
>
> **journal** `object` *required*
>
> Journal data to create or replace.
>
> **journal\_id** `string` *required*
>
> ID of the existing journal to replace.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
