Attribute cash income to a holding
attribute_cash_transactionAttribute an unmatched cash credit from a bank account to the holding that earned it, creating a security transaction and marking the cash row as the matched settlement leg to prevent double counting.
Instructions
Link an income credit already sitting on a bank account — e.g. a dividend or distribution that landed via the bank feed — to the holding that earned it. Recognises the income on a NEW security transaction (the single source of truth Holding, Fund and the tax summaries read income & franking from) and marks this cash row as its matched settlement leg, so income is counted exactly once. Unlike record_income this is a DIRECT write, NOT a Review-Queue proposal: the cash has already arrived, you are only saying which holding it belongs to. The row must be a credit (money in) that isn't already linked to a transaction — find candidates with list_cash_transactions (match_status "unmatched", category income_* or uncategorised). Identify the holding by ticker (preferred) or holding_id, and include franking_credits for franked dividends. Undo from the app (Detach) if you pick the wrong holding.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | ||
| ticker | No | Ticker of the holding that earned the income (preferred identifier) | |
| fund_id | Yes | Fund ID (discover via whoami or list_funds) | |
| holding_id | No | Holding ID, if already known (alternative to ticker) | |
| income_type | No | Income type to recognise; defaults from the row's category, else "dividend" | |
| payment_date | No | Payment date (defaults to the cash row's posted date) as an ISO date, e.g. "2026-05-30" | |
| bank_account_id | Yes | Bank account the cash row is on (find via list_bank_accounts) | |
| ex_dividend_date | No | Ex-dividend date as an ISO date, e.g. "2026-05-30" | |
| franking_credits | No | Franking credits attached (AUD) — for franked dividends | |
| cash_transaction_id | Yes | The income cash row to attribute (find via list_cash_transactions) | |
| franking_percentage | No | Franking percentage 0–100, for partially-franked dividends |