Create a fixed cost
recurring_createCreate a recurring fixed-cost template that automatically books expenses at set intervals, such as monthly rent, starting from the next due date.
Instructions
Create a new fixed-cost template (for example monthly rent) that the app books automatically as an expense every intervalMonths, starting at nextDueAt. Use it for charges that repeat; for a one-off payment use expense_create. It does not book a charge itself. Any member may create one. If paidByMemberId is not you, you must carry a positive share in splits, otherwise 403 paid_by_must_include_caller; members who left fail with 400 member_not_in_wg. Returns the new template as recurringExpense. The call carries an idempotency key, so a retried request is not created twice.
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": {
"description": "<description>",
"amountCents": "<amountCents>",
"paidByMemberId": "<paidByMemberId>",
"nextDueAt": "<nextDueAt>",
"splits": "<splits>"
},
"name": "recurring_create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| splits | Yes | Who owes what per charge, one entry per member. Amounts must add up to amountCents. Member ids come from members_list. | |
| wgCode | No | Share code of the flat (code from wg_list). Leave it out when the account belongs to one flat. | |
| category | No | Category given to each booked expense. Defaults to other. | other |
| currency | No | Fixed-cost templates are always in EUR, which is the only accepted value (the app rejects others with recurring_currency_unsupported). Omit it. | EUR |
| nextDueAt | Yes | When the first charge is due, ISO 8601 with offset. May lie up to 366 days in the past (then the app books the missed cycles) and up to 10 years ahead; later dates keep this day of the month. | |
| amountCents | Yes | Amount of each charge in cents of EUR, for example 85000 for 850.00 EUR. | |
| description | Yes | Short label shown in the expense list for every booked charge, for example "Rent". | |
| intervalMonths | No | Months between two charges: 1 monthly, 3 quarterly, 12 yearly. Defaults to 1. | |
| paidByMemberId | Yes | Member who pays the charge and is owed the money back, from members_list. Usually the tenant who pays the landlord. |