Splitwise

These are the Splitwise actions available to the apps you build with Snow. Connecting an account does not make Snow run these on its own.

• Add Friend

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

• 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.

• 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.

• 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.

• Create Friends

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

• 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.

• Delete Comment

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

• 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.

• 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.

• 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.

• Get Categories

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

• 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.

• Get Currencies

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

• Get Current User

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

• 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.

• 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.

• Get Friend Details

  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.

• Get Friends

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

• Get Group Details

  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.

• 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.

• 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.

• 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.

• Restore Deleted 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.

• Restore Deleted 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.

• 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.

• 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.

• Get User Information

  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.