Record income
record_incomeRecord dividend, distribution, interest, or rental income directly to your SMSF ledger without review. Use when a dividend statement, distribution advice, or rent receipt is found.
Instructions
Record an income event — dividend, distribution, interest or rental income — directly to your SMSF ledger. This writes immediately; there is no review step. Use when a dividend statement, distribution advice or rent receipt is found. Identify the holding by ticker or holding_id (it must already exist). Include franking_credits for franked dividends (important for SMSF tax). Always pass external_ref when the source has a stable ID so repeat imports are idempotent. Pass reasoning to record why (saved for the audit trail). All amounts AUD unless currency says otherwise.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | ||
| ticker | No | Ticker symbol of the holding (preferred way to identify it) | |
| fund_id | Yes | Fund ID (discover via whoami or list_funds) | |
| currency | No | Currency code (default "AUD") | |
| reasoning | No | Why this income is recorded (cite the source) — saved to the audit trail | |
| holding_id | No | Holding ID, if already known | |
| external_ref | No | Idempotency key derived from the source, e.g. '<email-message-id>:VAS:2026-03-28' | |
| payment_date | No | Payment date as an ISO date, e.g. "2026-05-30" | |
| total_amount | Yes | Cash amount received (AUD unless currency set) | |
| 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 | |
| transaction_date | Yes | Income date (usually the payment date) as an ISO date, e.g. "2026-05-30" | |
| transaction_type | Yes | Income type |