update_payee
Update a Payee. Leave a field out to keep it. Renaming preserves the previous canonical name as an alias so historical matches still resolve, and refuses a name another payee or alias already uses. Sets the default category and how it is applied (categorizationMode), the default tags and the default location for new transactions, and the logo (a brand domain or a monogram, not both; a logo set here is kept as manual). Returns the Payee. Requires finance:write scope.
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": {
"id": "<id>"
},
"name": "update_payee"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Payee id. | |
| name | No | New display name, 1 to 200 characters. | |
| logoIcon | No | Icon key shown instead of a brand logo or monogram (e.g. "food-24-regular"), or null to clear. Not together with logoDomain or logoInitials. | |
| logoColor | No | Monogram background as #rrggbb, or null for the default tint. | |
| logoDomain | No | Brand domain to take the logo from (e.g. "netflix.com", no protocol or slashes), or null to clear. Not together with logoInitials. | |
| logoInitials | No | One or two characters shown as a monogram instead of a brand logo, or null to clear. Not together with logoDomain. | |
| defaultTagIds | No | The full set of default tags for new transactions of this payee. It replaces the current set; [] clears it. Use apply_payee_tags_to_transactions (automations toolset) to tag the existing transactions. | |
| defaultLocation | No | Default location { latitude, longitude } stamped on new transactions of this payee, or null to clear. | |
| defaultCategoryId | No | New default category id, or null to clear. | |
| categorizationMode | No | How the default category is used on new transactions: enforce (always set it), hint (suggest it) or off (ignore it). |