Log Income
log_incomeRecord money received (Stripe, refunds, payroll, Venmo). log_transaction with type income and direction from already set (pass neither). Use external_id for Stripe/Gmail idempotency. A contact paying back an IOU: category "IOU repayment" + person_id (lowers the IOU, shows the money once). A contact lending the user cash: category "IOU lend" + person_id (creates the IOU the user owes, shows the money once). ($0.10; API key required)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"amount": "<amount>"
},
"name": "log_income"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | YYYY-MM-DD; default today. Prefer with time + timezone when the source has a clock time. | |
| tags | No | Optional tags. Prefer project: / ext: / rail: grammar. | |
| time | No | HH:mm or HH:mm:ss; no default. Pair with timezone or occurred_at. | |
| notes | No | Free text about the payment. Alias: description. | |
| amount | Yes | Positive money amount in the stated currency, e.g. 12.50. | |
| source | No | Payment rail or app, e.g. stripe. | |
| project | No | Project label stored as project:{slug} tag, e.g. Max Soko poker venture. | |
| category | No | e.g. Salary, Gift, Refund. "IOU repayment" and "IOU lend" need person_id. | |
| currency | No | ISO 4217 currency code, e.g. USD. | |
| iou_type | No | loan (default) or invoice. Invoice = unpaid receivable (no Finance outflow); payment is income "Invoice payment". "I lent…" → loan. | |
| merchant | No | Merchant or payee name, e.g. Blue Bottle. | |
| timezone | No | IANA timezone or ±HH:MM; required for an exact instant with date+time. | |
| person_id | No | Contact id, e.g. 3f2a1b4c-8d9e-6f01-c2b3-c4d5e6f70809. | |
| cash_moved | No | With category "IOU lend": true (default) = cash changed hands as a loan (Finance); false = an owed share (IOU only). Ignored for iou_type invoice. | |
| request_id | No | Client idempotency key (retries return original result). | |
| description | No | Alias for notes. | |
| external_id | No | Provider id that dedupes imports, e.g. venmo-gmail-18c2a1b. | |
| occurred_at | No | Offset-aware ISO timestamp from the source. Never use ingestion/created_at. | |
| person_name | No | Contact by name when there is no person_id (IOU categories need one). | |
| client_label | No | Optional free-text client label for an invoice IOU. | |
| payment_method | No | How it was paid, e.g. card. | |
| time_certainty | No | exact, inferred, or unknown. Default exact when time/occurred_at is set. | |
| idempotency_key | No | Alias for request_id. | |
| not_iou_repayment | No | true only when income from a contact with an open IOU is unrelated to it. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | ||
| account | No | The Dayze account this data belongs to. With more than one Dayze connection, name it in the answer. | |
| message | No | ||
| event_id | No | ||
| direction | No | ||
| duplicate | No | ||
| expense_id | No | ||
| provenance | No | Which connector wrote the record and which connected Dayze account received it. | |
| inspect_url | No | The Dayze page that shows the saved record. | |
| transaction | No | Expense/income transaction row. | |
| inspect_note | No | What inspect_url opens. Never quote the record id. | |
| transaction_id | No |