create_payee
Create a Payee (merchant/counterparty) for the user. Use when the user wants to register a new merchant before linking transactions. Can also set the categorization mode, the default tags and the default location. Returns the created 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": {
"name": "<name>"
},
"name": "create_payee"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Display name for the Payee, max 200 chars. | |
| defaultTagIds | No | Tag ids (from get_tags) added to new transactions of this payee. 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. | |
| defaultCategoryId | No | Optional category id automatically applied to future transactions linked to this Payee. | |
| categorizationMode | No | How the default category is used on new transactions: enforce (always set it, the default), hint (suggest it) or off (ignore it). |