create_expense
Create a new expense in Splitwise with equal or custom splits. Specify cost and description, optionally add group, users, date, currency, category, and details.
Instructions
Create a new expense.
cost is a decimal string, e.g. "25.00". description is required.
Splitting:
Equal split (default): leave
usersempty; the cost is split evenly among everyone in the resolved group (group_id or SPLITWISE_GROUP_ID).Custom split: pass
users, a list of dicts each like {"user_id": 123, "paid_share": "25.00", "owed_share": "12.50"}. Identify a user by user_id, or by email/first_name/last_name. The paid_share values must sum to cost, and so must the owed_share values.
date accepts ISO 8601 (e.g. "2026-06-15T00:00:00Z"). currency_code is a 3-letter code (e.g. "USD"). category_id and details are optional.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cost | Yes | ||
| date | No | ||
| users | No | ||
| details | No | ||
| group_id | No | ||
| category_id | No | ||
| description | Yes | ||
| currency_code | No | ||
| split_equally | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||