Skip to main content
Splitwise logo
  • Category: accounting
  • Auth: OAUTH2, API_KEY
  • Composio-managed OAuth available? Yes
  • Tools: 27
  • Triggers: 0
  • Slug: SPLITWISE
  • Version: 20261101_00

Tools

Slug: SPLITWISE_ADD_FRIENDTool to add a new friend to Splitwise. Use when you have the friend’s email and name details ready.

Input Parameters

string
required
Email address of the friend to add
string
Last name of the friend (optional)
string
required
First name of the friend; required by Splitwise to create a new friend entry

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_ADD_USER_TO_GROUPTool 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.

Input Parameters

string
required
The ID of the user being added to the group
string
required
The ID of the group to add the user to

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_CREATE_COMMENTTool to create a comment on a specific expense. Use when you need to add a comment or note to an existing expense.

Input Parameters

string
required
The text content of the comment.
string
required
The ID of the expense to which the comment will be added.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_CREATE_EXPENSECreates a Splitwise expense for a group or between users to record a bill or payment. Choose an equal group split or custom participant shares; for custom shares, the paid and owed amounts must each add up to the total cost.

Input Parameters

string
required
Total cost as string decimal (up to 2 decimal places)
string
Date when the expense occurred (ISO 8601 format). Defaults to current time if omitted
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’).
string
Additional notes or details about the expense
string
required
ID of the group to add this expense to. Use 0 for expenses between friends (not in a group)
string
Expense category ID (use get_categories action to retrieve valid IDs). Defaults to ‘General’
string
required
Brief description of what the expense is for
string
3-letter ISO currency code (e.g., USD, EUR, GBP). Defaults to user’s default currency
boolean
Set to true to split cost equally. When group_id=0, you must also provide users list to specify participants
string ("never" | "weekly" | "fortnightly" | "monthly" | "yearly")
How often this expense repeats. Use ‘never’ or omit for one-time expenses

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_CREATE_FRIENDSTool to add multiple friends at once to Splitwise. Use when you need to add several friends in a single operation.

Input Parameters

array
required
List of users to add as friends. Each user must have an email and first_name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_CREATE_GROUPTool 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.

Input Parameters

string
required
The name of the group to create
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.
string ("home" | "trip" | "couple" | "other" | "apartment" | "house")
Type of group being created. Options: ‘home’, ‘trip’, ‘couple’, ‘other’, ‘apartment’, ‘house’
boolean
Whether to turn on simplified debts for this group

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_DELETE_COMMENTTool to delete a comment by its ID. Use after confirming you have a valid comment ID.

Input Parameters

string
required
The unique identifier of the comment to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_DELETE_EXPENSEDeletes an existing expense by ID; Splitwise supports restoring deleted expenses. Check the response’s success field to verify deletion; HTTP errors are raised separately.

Input Parameters

string
required
Unique identifier of the expense to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_DELETE_FRIENDTool 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.

Input Parameters

string
required
The unique identifier of the friend to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_DELETE_GROUPDeletes a group by ID and destroys its associated records, including expenses.

Input Parameters

string
required
The unique identifier of the group to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_GET_CATEGORIESTool to retrieve expense categories. Use when you need to list available categories before creating an expense.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_GET_COMMENTSTool 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.

Input Parameters

string
required
The ID of the expense for which to retrieve comments.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_GET_CURRENCIESTool to retrieve a list of supported currencies. Use when you need to display or validate currency options.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_GET_CURRENT_USERTool to retrieve information about the current authenticated user. Use when you need profile details of the logged-in user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_GET_EXPENSETool to retrieve detailed information about a specific expense by ID. Use when you need to view expense details including participants, shares, and repayments.

Input Parameters

integer
required
The unique identifier for the expense.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_GET_EXPENSESLists the current user’s Splitwise expenses with optional date, group, and friend filters. Results are paginated; when both group and friend are specified, the group filter takes precedence.

Input Parameters

integer
Maximum number of expenses to return per request. Useful for controlling page size.
integer
Number of expenses to skip for pagination. Use for loading subsequent pages of results.
boolean
Show only non-deleted expenses when true. Set to false to include deleted expenses.
integer
Filter expenses by specific group ID. Returns only expenses belonging to this group.
integer
Filter expenses by specific friend ID. Returns only expenses involving this friend.
string
Return expenses dated after this date. Must be ISO 8601 datetime format.
string
Return expenses dated before this date. Must be ISO 8601 datetime format.
string
Return expenses updated after this date. Must be ISO 8601 datetime format.
string
Return expenses updated before this date. Must be ISO 8601 datetime format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_GET_FRIENDTool 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.

Input Parameters

string
required
User ID of the friend to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_GET_FRIENDSTool to list current user’s friends on Splitwise. Use when you need to view all friends, their balances, and shared groups.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_GET_GROUPRetrieves details for a specific group, including members, balances, original and simplified debts, avatar URLs, and settings. Group ID 0 represents expenses not associated with a group.

Input Parameters

string
required
The unique identifier of the group to retrieve. Use 0 to get non-group expenses.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_GET_GROUPSRetrieves 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.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_GET_NOTIFICATIONSTool 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.

Input Parameters

integer
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.
string
If provided, returns only notifications after this time. Must be ISO 8601 datetime format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_GET_USERRetrieves 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.

Input Parameters

string
required
The user ID of the person whose information you want to retrieve Prefer IDs sourced from SPLITWISE_GET_GROUP responses to ensure validity.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_REMOVE_USER_FROM_GROUPTool 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.

Input Parameters

string
required
The ID of the user to remove from the group. User must have a zero balance in the group to be removed.
string
required
The ID of the group from which to remove the user

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_UNDELETE_EXPENSERestores a previously deleted expense by ID. Check the response’s success value; HTTP 200 alone does not indicate successful restoration.

Input Parameters

string
required
The unique identifier of the expense to restore.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_UNDELETE_GROUPRestores a previously deleted group by ID. Check the response’s success value; HTTP 200 alone does not indicate successful restoration.

Input Parameters

string
required
The unique identifier of the group to restore.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_UPDATE_EXPENSEUpdates an existing Splitwise expense’s details, such as cost, description, or participant shares; supplying participant shares overwrites all existing shares. Check that the returned errors object is empty; HTTP 200 alone does not guarantee success.

Input Parameters

string
required
ID of the expense to update
string
Total cost as string decimal with max 2 dp
string
When the expense took place (ISO 8601) Convert natural-language or locale-specific dates to ISO 8601 before sending.
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.
string
Additional notes for the expense
string
Group ID to assign this expense to (0 for no group)
string
Category ID from get_categories
string
Short description of the expense
string
3-letter currency code, e.g., USD
string ("never" | "weekly" | "fortnightly" | "monthly" | "yearly")
Repeat interval for the expense

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SPLITWISE_UPDATE_USERTool to update user account details including name, email, password, and preferences. Use when you need to modify the current user’s profile information.

Input Parameters

string
required
The user ID to update. Must be the authenticated user’s ID.
string
User’s email address
string
Language/region preference (e.g., ‘en’, ‘es’, ‘fr’)
string
User’s account password
string
User’s family name
string
User’s given name
string
Preferred currency code (e.g., ‘USD’, ‘EUR’, ‘GBP’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not