# Splitwise

Your Toolhouse AI Worker can connect to Splitwise using 27 specialized tools.

## Auth Connection

This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=splitwise).

## Tools (27)

### `Splitwise Add Friend`

Integration name: **SPLITWISE\_ADD\_FRIEND**

Tool to add a new friend to Splitwise. Use when you have the friend's email and name details ready.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                | Description                                                                  |
| ----------------- | ------ | :------: | ---------------------- | ---------------------------------------------------------------------------- |
| `user_email`      | string |     ✅    | `"friend@example.com"` | Email address of the friend to add                                           |
| `user_last_name`  | string |          | `"Doe"`                | Last name of the friend (optional)                                           |
| `user_first_name` | string |     ✅    | `"John"`               | First name of the friend; required by Splitwise to create a new friend entry |

***

### `Splitwise Add User To Group`

Integration name: **SPLITWISE\_ADD\_USER\_TO\_GROUP**

Tool to add a user to a group. Use when you need to add an existing Splitwise user to a specific group. Note: 200 OK does not indicate success; always check the response 'success' field.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type    | Required | Example    | Description                                 |
| ---------- | ------- | :------: | ---------- | ------------------------------------------- |
| `user_id`  | integer |     ✅    | `2084357`  | The ID of the user being added to the group |
| `group_id` | integer |     ✅    | `90997466` | The ID of the group to add the user to      |

***

### `Splitwise Create Comment`

Integration name: **SPLITWISE\_CREATE\_COMMENT**

Tool to create a comment on a specific expense. Use when you need to add a comment or note to an existing expense.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                    | Description                                               |
| ------------ | ------- | :------: | -------------------------- | --------------------------------------------------------- |
| `content`    | string  |     ✅    | `"Does this include tax?"` | The text content of the comment.                          |
| `expense_id` | integer |     ✅    | `4196161261`               | The ID of the expense to which the comment will be added. |

***

### `Splitwise Create Expense`

Integration name: **SPLITWISE\_CREATE\_EXPENSE**

Tool to create a new Splitwise expense. Use when you need to record a payment or bill in a group or between users. Provide exactly one of split\_equally or users for shares — supplying both or neither causes a validation error and no expense is created.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example                  | Description                                                                                                                                                                                                                             |
| ----------------- | ------- | :------: | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `cost`            | string  |     ✅    | `"25.00"`                | Total cost as string decimal (up to 2 decimal places)                                                                                                                                                                                   |
| `date`            | string  |          | `"2026-01-25T18:30:00Z"` | Date when the expense occurred (ISO 8601 format). Defaults to current time if omitted                                                                                                                                                   |
| `users`           | array   |          | —                        | List of participants with custom share amounts. Required when using custom splits instead of split\_equally Each user object must include `paid_share` and `owed_share` as decimal strings with up to 2 decimal places (e.g., '25.00'). |
| `details`         | string  |          | —                        | Additional notes or details about the expense                                                                                                                                                                                           |
| `group_id`        | integer |     ✅    | `0`                      | ID of the group to add this expense to. Use 0 for expenses between friends (not in a group)                                                                                                                                             |
| `category_id`     | integer |          | `15`                     | Expense category ID (use get\_categories action to retrieve valid IDs). Defaults to 'General'                                                                                                                                           |
| `description`     | string  |     ✅    | `"Grocery run"`          | Brief description of what the expense is for                                                                                                                                                                                            |
| `currency_code`   | string  |          | `"USD"`                  | 3-letter ISO currency code (e.g., USD, EUR, GBP). Defaults to user's default currency                                                                                                                                                   |
| `split_equally`   | boolean |          | `true`                   | Set to true to split cost equally. When group\_id=0, you must also provide users list to specify participants                                                                                                                           |
| `repeat_interval` | string  |          | `"monthly"`              | How often this expense repeats. Use 'never' or omit for one-time expenses                                                                                                                                                               |

***

### `Splitwise Create Friends`

Integration name: **SPLITWISE\_CREATE\_FRIENDS**

Tool to add multiple friends at once to Splitwise. Use when you need to add several friends in a single operation.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type  | Required | Example                                                                   | Description                                                                    |
| --------- | ----- | :------: | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| `users`   | array |     ✅    | `[{"email":"alan@example.org","last_name":"Turing","first_name":"Alan"}]` | List of users to add as friends. Each user must have an email and first\_name. |

***

### `Splitwise Create Group`

Integration name: **SPLITWISE\_CREATE\_GROUP**

Tool to create a new group in Splitwise. Use when you need to create a group for tracking shared expenses. The current user is automatically added to the group. You can optionally add other members during creation.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter             | Type    | Required | Example           | Description                                                                                                                                                          |
| --------------------- | ------- | :------: | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`                | string  |     ✅    | `"Trip to Paris"` | The name of the group to create                                                                                                                                      |
| `users`               | array   |          | —                 | List of users to add to the group. Each user needs either user\_id or email. If invited by email only, first\_name is required by Splitwise; last\_name is optional. |
| `group_type`          | string  |          | `"trip"`          | Type of group being created. Options: 'home', 'trip', 'couple', 'other', 'apartment', 'house'                                                                        |
| `simplify_by_default` | boolean |          | `true`            | Whether to turn on simplified debts for this group                                                                                                                   |

***

### `Splitwise Delete Comment`

Integration name: **SPLITWISE\_DELETE\_COMMENT**

Tool to delete a comment by its ID. Use after confirming you have a valid comment ID.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example     | Description                                     |
| --------- | ------- | :------: | ----------- | ----------------------------------------------- |
| `id`      | integer |     ✅    | `971044906` | The unique identifier of the comment to delete. |

***

### `Splitwise Delete Expense`

Integration name: **SPLITWISE\_DELETE\_EXPENSE**

Tool to delete an existing expense by its ID. Deletion is irreversible — no undelete capability exists. Use after confirming you have the correct expense ID. Inspect the response's `success` and `error` fields to verify deletion succeeded; failures (e.g., user lacks owner/participant permissions) are surfaced there.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                 |
| --------- | ------- | :------: | ------- | ------------------------------------------- |
| `id`      | integer |     ✅    | `12345` | Unique identifier of the expense to delete. |

***

### `Splitwise Delete Friend`

Integration name: **SPLITWISE\_DELETE\_FRIEND**

Tool to delete an existing friend by ID. Use when you need to remove a friend relationship by its user ID. Call after confirming the correct friend ID.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example  | Description                                    |
| ----------- | ------- | :------: | -------- | ---------------------------------------------- |
| `friend_id` | integer |     ✅    | `123456` | The unique identifier of the friend to delete. |

***

### `Splitwise Delete Group`

Integration name: **SPLITWISE\_DELETE\_GROUP**

Tool to delete a group and all associated records by its ID. Use when you need to permanently remove a group and its expenses. Call after confirming the correct group ID.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example    | Description                                   |
| --------- | ------- | :------: | ---------- | --------------------------------------------- |
| `id`      | integer |     ✅    | `91033637` | The unique identifier of the group to delete. |

***

### `Splitwise Get Categories`

Integration name: **SPLITWISE\_GET\_CATEGORIES**

Tool to retrieve expense categories. Use when you need to list available categories before creating an expense.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

*No parameters required.*

***

### `Splitwise Get Comments`

Integration name: **SPLITWISE\_GET\_COMMENTS**

Tool to retrieve all comments associated with a specific expense. Use when you need to view comments on an expense, including both system-generated updates and user-authored messages.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example      | Description                                           |
| ------------ | ------- | :------: | ------------ | ----------------------------------------------------- |
| `expense_id` | integer |     ✅    | `3896022943` | The ID of the expense for which to retrieve comments. |

***

### `Splitwise Get Currencies`

Integration name: **SPLITWISE\_GET\_CURRENCIES**

Tool to retrieve a list of supported currencies. Use when you need to display or validate currency options.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

*No parameters required.*

***

### `Splitwise Get Current User`

Integration name: **SPLITWISE\_GET\_CURRENT\_USER**

Tool to retrieve information about the current authenticated user. Use when you need profile details of the logged-in user.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

*No parameters required.*

***

### `Splitwise Get Expense`

Integration name: **SPLITWISE\_GET\_EXPENSE**

Tool to retrieve detailed information about a specific expense by ID. Use when you need to view expense details including participants, shares, and repayments.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example      | Description                            |
| --------- | ------- | :------: | ------------ | -------------------------------------- |
| `id`      | integer |     ✅    | `4196161261` | The unique identifier for the expense. |

***

### `Splitwise Get Expenses`

Integration name: **SPLITWISE\_GET\_EXPENSES**

Tool to list the current user's expenses from Splitwise account. Use when you need to view expenses with optional filters like date ranges, groups, or friends.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type    | Required | Example                  | Description                                                                             |
| ---------------- | ------- | :------: | ------------------------ | --------------------------------------------------------------------------------------- |
| `limit`          | integer |          | `10`                     | Maximum number of expenses to return per request. Useful for controlling page size.     |
| `offset`         | integer |          | `0`                      | Number of expenses to skip for pagination. Use for loading subsequent pages of results. |
| `visible`        | boolean |          | `true`                   | Show only non-deleted expenses when true. Set to false to include deleted expenses.     |
| `group_id`       | integer |          | `12345`                  | Filter expenses by specific group ID. Returns only expenses belonging to this group.    |
| `friend_id`      | integer |          | `67890`                  | Filter expenses by specific friend ID. Returns only expenses involving this friend.     |
| `dated_after`    | string  |          | `"2024-01-01T00:00:00Z"` | Return expenses dated after this date. Must be ISO 8601 datetime format.                |
| `dated_before`   | string  |          | `"2024-12-31T23:59:59Z"` | Return expenses dated before this date. Must be ISO 8601 datetime format.               |
| `updated_after`  | string  |          | `"2024-01-01T00:00:00Z"` | Return expenses updated after this date. Must be ISO 8601 datetime format.              |
| `updated_before` | string  |          | `"2024-12-31T23:59:59Z"` | Return expenses updated before this date. Must be ISO 8601 datetime format.             |

***

### `Splitwise Get Friend`

Integration name: **SPLITWISE\_GET\_FRIEND**

Tool to retrieve detailed information about a specific friend. Use when you need to get profile details and balance information for a friend by their user ID.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example   | Description                       |
| --------- | ------- | :------: | --------- | --------------------------------- |
| `id`      | integer |     ✅    | `2084357` | User ID of the friend to retrieve |

***

### `Splitwise Get Friends`

Integration name: **SPLITWISE\_GET\_FRIENDS**

Tool to list current user's friends on Splitwise. Use when you need to view all friends, their balances, and shared groups.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

*No parameters required.*

***

### `Splitwise Get Group`

Integration name: **SPLITWISE\_GET\_GROUP**

Tool to retrieve detailed information about a specific group. Returns full group details including members, balances, debts (both original and simplified), avatar URLs, and group settings. Use this when you need comprehensive information about a particular group, such as viewing who owes what to whom. Use group ID of 0 to get non-group expenses.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                                                      |
| --------- | ------- | :------: | ------- | -------------------------------------------------------------------------------- |
| `id`      | integer |     ✅    | `12345` | The unique identifier of the group to retrieve. Use 0 to get non-group expenses. |

***

### `Splitwise Get Groups`

Integration name: **SPLITWISE\_GET\_GROUPS**

Retrieves all groups the authenticated user belongs to, including group details, members, balances, and debt information. Returns a 'groups' array with no server-side filtering; all name- or ID-based filtering must be done client-side on the full response. Group names may share similar strings or differ in case/whitespace — normalize when matching and prefer group\_id once identified. The groups array may be empty if the user belongs to no groups.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

*No parameters required.*

***

### `Splitwise Get Notifications`

Integration name: **SPLITWISE\_GET\_NOTIFICATIONS**

Tool to retrieve recent activity notifications from the user's Splitwise account. Returns notifications with HTML content suitable for display, with the most recent items first. Use when you need to view recent account activity or updates.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                  | Description                                                                                                                                                                   |
| --------------- | ------- | :------: | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`         | integer |          | `0`                      | Maximum number of notifications to return. Omit or provide 0 to get the maximum number of notifications. The server sets arbitrary (but large) limits on the number returned. |
| `updated_after` | string  |          | `"2020-07-28T20:46:00Z"` | If provided, returns only notifications after this time. Must be ISO 8601 datetime format.                                                                                    |

***

### `Splitwise Get User`

Integration name: **SPLITWISE\_GET\_USER**

Retrieves basic profile information about any Splitwise user by their ID. Returns the user's name, email, registration status, and profile picture. This endpoint only returns public user information. For the authenticated user's full profile (including notifications, currency preferences, and locale settings), use get\_current\_user instead.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example     | Description                                                                                                                                  |
| --------- | ------- | :------: | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`      | integer |     ✅    | `104819933` | The user ID of the person whose information you want to retrieve Prefer IDs sourced from SPLITWISE\_GET\_GROUP responses to ensure validity. |

***

### `Splitwise Remove User From Group`

Integration name: **SPLITWISE\_REMOVE\_USER\_FROM\_GROUP**

Tool to remove a user from a group. Use when you need to remove a user from a specific group. Note: User must have a zero balance in the group for removal to succeed. 200 OK does not indicate success; always check the response 'success' field.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type    | Required | Example     | Description                                                                                            |
| ---------- | ------- | :------: | ----------- | ------------------------------------------------------------------------------------------------------ |
| `user_id`  | integer |     ✅    | `107522656` | The ID of the user to remove from the group. User must have a zero balance in the group to be removed. |
| `group_id` | integer |     ✅    | `90996631`  | The ID of the group from which to remove the user                                                      |

***

### `Splitwise Undelete Expense`

Integration name: **SPLITWISE\_UNDELETE\_EXPENSE**

Tool to restore a previously deleted expense and its associated records. Use when you need to recover an expense that was deleted. Call after confirming the correct expense ID. Not a guaranteed undo mechanism — treat deletion as high-impact and verify restoration completeness afterward.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example      | Description                                      |
| --------- | ------- | :------: | ------------ | ------------------------------------------------ |
| `id`      | integer |     ✅    | `3896437486` | The unique identifier of the expense to restore. |

***

### `Splitwise Undelete Group`

Integration name: **SPLITWISE\_UNDELETE\_GROUP**

Tool to restore a previously deleted group and all its associated records. Use when you need to recover a group that was deleted. Call after confirming the correct group ID.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example    | Description                                    |
| --------- | ------- | :------: | ---------- | ---------------------------------------------- |
| `id`      | integer |     ✅    | `91033632` | The unique identifier of the group to restore. |

***

### `Splitwise Update Expense`

Integration name: **SPLITWISE\_UPDATE\_EXPENSE**

Tool to update an existing Splitwise expense. Use when you need to modify expense details such as cost, description, or participant shares. Only include fields you want to change. Note that a 200 OK response does not guarantee success - check that the errors object is empty.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example                          | Description                                                                                                                                                                                                                                                                                       |
| ----------------- | ------- | :------: | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`              | integer |     ✅    | `4196161261`                     | ID of the expense to update                                                                                                                                                                                                                                                                       |
| `cost`            | string  |          | `"25.00"`                        | Total cost as string decimal with max 2 dp                                                                                                                                                                                                                                                        |
| `date`            | string  |          | `"2012-05-02T13:00:00Z"`         | When the expense took place (ISO 8601) Convert natural-language or locale-specific dates to ISO 8601 before sending.                                                                                                                                                                              |
| `users`           | array   |          | —                                | List of custom share allocations. WARNING: If provided, ALL expense shares will be overwritten Each user entry must include `paid_share` and `owed_share`; both fields must each independently sum exactly to `cost`. Omit this field entirely unless a full overwrite of all shares is intended. |
| `details`         | string  |          | —                                | Additional notes for the expense                                                                                                                                                                                                                                                                  |
| `group_id`        | integer |          | `0`                              | Group ID to assign this expense to (0 for no group)                                                                                                                                                                                                                                               |
| `category_id`     | integer |          | `15`                             | Category ID from get\_categories                                                                                                                                                                                                                                                                  |
| `description`     | string  |          | `"Updated test expense via API"` | Short description of the expense                                                                                                                                                                                                                                                                  |
| `currency_code`   | string  |          | `"USD"`                          | 3-letter currency code, e.g., USD                                                                                                                                                                                                                                                                 |
| `repeat_interval` | string  |          | `"never"`                        | Repeat interval for the expense                                                                                                                                                                                                                                                                   |

***

### `Splitwise Update User`

Integration name: **SPLITWISE\_UPDATE\_USER**

Tool to update user account details including name, email, password, and preferences. Use when you need to modify the current user's profile information.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type    | Required | Example                  | Description                                                 |
| ------------------ | ------- | :------: | ------------------------ | ----------------------------------------------------------- |
| `id`               | integer |     ✅    | `104819933`              | The user ID to update. Must be the authenticated user's ID. |
| `email`            | string  |          | `"john.doe@example.com"` | User's email address                                        |
| `locale`           | string  |          | `"en"`                   | Language/region preference (e.g., 'en', 'es', 'fr')         |
| `password`         | string  |          | —                        | User's account password                                     |
| `last_name`        | string  |          | `"Doe"`                  | User's family name                                          |
| `first_name`       | string  |          | `"John"`                 | User's given name                                           |
| `default_currency` | string  |          | `"USD"`                  | Preferred currency code (e.g., 'USD', 'EUR', 'GBP')         |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.toolhouse.ai/toolhouse/integrations/splitwise.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.