upsert_budget
Create or update a budget for a category and period. Set amounts to control spending and track financial goals.
Instructions
Create or update a budget for a category and budget period. The start_date must be a valid budget period start for the account (see get_budget_settings).
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": {
"start_date": "<start_date>",
"category_id": "<category_id>",
"amount": "<amount>"
},
"name": "upsert_budget"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | Optional notes for the budget period. | |
| amount | Yes | Budget amount. | |
| currency | No | Three-letter lowercase currency code (defaults to primary currency). | |
| start_date | Yes | Budget period start date in YYYY-MM-DD format. Must be a valid budget period start; if not, the API returns the previous and next valid start dates. | |
| category_id | Yes | Category ID for the budget. |