Splitwise
App · 14 actions
Share costs with Splitwise: add expenses split with a group or a friend, see who owes whom, and comment on expenses. Start a workflow when an expense is added.
Actions
| Action | What it does |
|---|---|
| Add expense | Add an expense, split equally in a group or between you and a friend. |
| Change expense | Change an expense's description, amount, date or notes. |
| Comment on expense | Add a comment to an expense, which everyone on it sees. |
| Create group | Make a group with just you in it, such as for a trip or a household. |
| Delete expense | Delete an expense. |
| Delete group | Delete a group and its expenses. |
| Get expense | Get one expense: its cost, who paid and who owes what. |
| Get group | Get one group: its members and who owes whom. |
| Get my account | Get your Splitwise name, email and default currency. |
| List comments | List an expense's comments, oldest first, including the ones Splitwise adds when it changes. |
| List expenses | List expenses, newest first, in a group or with a friend, between two dates. |
| List friends | List your friends, with what each owes you (positive) or you owe them (negative). |
| List groups | List your groups, with who owes whom in each. |
| Restore expense | Bring back a deleted expense. |
Add expense
Add an expense, split equally in a group or between you and a friend. Splitwise tells the others.
Inputs
- Description
descriptiontextRequired - What it was for, such as Groceries.
- Amount
costnumberRequired - How much it cost, such as 48.60.At least 0.01.
- Group
grouptext - The group to split it in, equally. Or pick a friend instead.
- Friend
friendtext - Instead of a group, the friend to split it with, half each.
- Paid by
paid_bytext - With a friend, who paid. Defaults to you.One of:
me(I paid),friend(My friend paid). Default:me. - Currency
currency_codetext - Its currency, such as EUR. Defaults to your default currency.
- Date
datedate - When it was spent. Defaults to today.
- Notes
detailstext - Notes about it.
- Repeats
repeattext - How often Splitwise adds it again. Defaults to never.One of:
never(Doesn't repeat),weekly(Every week),fortnightly(Every two weeks),monthly(Every month),yearly(Every year). Default:never.
Outputs
categorytext- Its category, such as Groceries
costnumber- How much it cost
created_attext- When it was added (ISO 8601)
created_bytext- Who added it
currencytext- Its currency code, such as USD
datetext- When it was spent (ISO 8601)
deletedtrue/false- True if it was deleted
descriptiontext- What it was for
detailstext- Its notes
group_idnumber- Its group; 0 if it isn't in one
idnumber- The expense's number
is_paymenttrue/false- True if it records someone paying someone back
shareslist- Who paid and who owes what
updated_attext- When it last changed (ISO 8601)
you_paidnumber- How much you paid
your_sharenumber- How much of it is yours
Example output
{
"category": "Groceries",
"cost": 48.6,
"created_at": "2026-10-28T12:01:00Z",
"created_by": "Alex Kim",
"currency": "USD",
"date": "2026-10-28T12:00:00Z",
"deleted": false,
"description": "Groceries",
"details": "",
"group_id": 5512,
"id": 3071209876,
"is_payment": false,
"shares": [
{
"name": "Alex Kim",
"owes": 24.3,
"paid": 48.6,
"user_id": 101
},
{
"name": "Sam Lee",
"owes": 24.3,
"paid": 0.0,
"user_id": 102
}
],
"updated_at": "2026-10-28T12:01:00Z",
"you_paid": 48.6,
"your_share": 24.3
}Change expense
Change an expense's description, amount, date or notes. A new amount is split as before.
Inputs
- Expense
expensetextRequired - The expense's number, from 'Add expense', 'List expenses' or the trigger.
- Description
descriptiontext - A new description. Leave empty to keep it.
- Amount
costnumber - A new amount. Leave empty to keep it.At least 0.01.
- Date
datedate - A new date. Leave empty to keep it.
- Notes
detailstext - New notes. Leave empty to keep them.
Outputs
categorytext- Its category, such as Groceries
costnumber- How much it cost
created_attext- When it was added (ISO 8601)
created_bytext- Who added it
currencytext- Its currency code, such as USD
datetext- When it was spent (ISO 8601)
deletedtrue/false- True if it was deleted
descriptiontext- What it was for
detailstext- Its notes
group_idnumber- Its group; 0 if it isn't in one
idnumber- The expense's number
is_paymenttrue/false- True if it records someone paying someone back
shareslist- Who paid and who owes what
updated_attext- When it last changed (ISO 8601)
you_paidnumber- How much you paid
your_sharenumber- How much of it is yours
Example output
{
"category": "Groceries",
"cost": 48.6,
"created_at": "2026-10-28T12:01:00Z",
"created_by": "Alex Kim",
"currency": "USD",
"date": "2026-10-28T12:00:00Z",
"deleted": false,
"description": "Groceries",
"details": "",
"group_id": 5512,
"id": 3071209876,
"is_payment": false,
"shares": [
{
"name": "Alex Kim",
"owes": 24.3,
"paid": 48.6,
"user_id": 101
},
{
"name": "Sam Lee",
"owes": 24.3,
"paid": 0.0,
"user_id": 102
}
],
"updated_at": "2026-10-28T12:01:00Z",
"you_paid": 48.6,
"your_share": 24.3
}Comment on expense
Add a comment to an expense, which everyone on it sees.
Inputs
- Expense
expensetextRequired - The expense's number, from 'Add expense', 'List expenses' or the trigger.
- Comment
contenttextRequired - What to say.
Outputs
contenttext- What it says
expense_idnumber- The expense
idnumber- The comment's number
Example output
{
"content": "Receipt is in the shared folder",
"expense_id": 3071209876,
"id": 88001
}Create group
Make a group with just you in it, such as for a trip or a household. Add people in Splitwise.
Inputs
- Name
nametextRequired - What to call it, such as Lisbon trip.
- Type
group_typetext - What it's for. Defaults to other.One of:
trip,home,couple,other. Default:other.
Outputs
debtslist- Who owes whom, simplified
idnumber- The group's number
memberslist- Its members
nametext- Its name
typetext- trip, home, couple or other
updated_attext- When it last changed (ISO 8601)
Example output
{
"debts": [],
"id": 5512,
"members": [
{
"id": 101,
"name": "Alex Kim"
}
],
"name": "Flat 4B",
"type": "home",
"updated_at": "2026-10-28T12:01:00Z"
}Delete expense
Delete an expense. 'Restore expense' brings it back.
Inputs
- Expense
expensetextRequired - The expense's number, from 'Add expense', 'List expenses' or the trigger.
Outputs
deletedtrue/false- True once deleted
idnumber- The expense's number
Example output
{
"deleted": true,
"id": 3071209876
}Delete group
Delete a group and its expenses. Splitwise's website can restore it.
Inputs
- Group
grouptextRequired - The group to delete.
Outputs
deletedtrue/false- True once deleted
idnumber- The group's number
Example output
{
"deleted": true,
"id": 5512
}Get expense
Get one expense: its cost, who paid and who owes what.
Inputs
- Expense
expensetextRequired - The expense's number, from 'Add expense', 'List expenses' or the trigger.
Outputs
categorytext- Its category, such as Groceries
costnumber- How much it cost
created_attext- When it was added (ISO 8601)
created_bytext- Who added it
currencytext- Its currency code, such as USD
datetext- When it was spent (ISO 8601)
deletedtrue/false- True if it was deleted
descriptiontext- What it was for
detailstext- Its notes
group_idnumber- Its group; 0 if it isn't in one
idnumber- The expense's number
is_paymenttrue/false- True if it records someone paying someone back
shareslist- Who paid and who owes what
updated_attext- When it last changed (ISO 8601)
you_paidnumber- How much you paid
your_sharenumber- How much of it is yours
Example output
{
"category": "Groceries",
"cost": 48.6,
"created_at": "2026-10-28T12:01:00Z",
"created_by": "Alex Kim",
"currency": "USD",
"date": "2026-10-28T12:00:00Z",
"deleted": false,
"description": "Groceries",
"details": "",
"group_id": 5512,
"id": 3071209876,
"is_payment": false,
"shares": [
{
"name": "Alex Kim",
"owes": 24.3,
"paid": 48.6,
"user_id": 101
},
{
"name": "Sam Lee",
"owes": 24.3,
"paid": 0.0,
"user_id": 102
}
],
"updated_at": "2026-10-28T12:01:00Z",
"you_paid": 48.6,
"your_share": 24.3
}Get group
Get one group: its members and who owes whom.
Inputs
- Group
grouptextRequired - The group.
Outputs
debtslist- Who owes whom, simplified
idnumber- The group's number
memberslist- Its members
nametext- Its name
typetext- trip, home, couple or other
updated_attext- When it last changed (ISO 8601)
Example output
{
"debts": [
{
"amount": 24.3,
"currency": "USD",
"from": "Sam Lee",
"to": "Alex Kim"
}
],
"id": 5512,
"members": [
{
"id": 101,
"name": "Alex Kim"
},
{
"id": 102,
"name": "Sam Lee"
}
],
"name": "Flat 4B",
"type": "home",
"updated_at": "2026-10-28T12:01:00Z"
}Get my account
Get your Splitwise name, email and default currency.
Inputs
None.
Outputs
default_currencytext- Your default currency
emailtext- Your email address
idnumber- Your user number
nametext- Your name
Example output
{
"default_currency": "USD",
"email": "alex@example.com",
"id": 101,
"name": "Alex Kim"
}List comments
List an expense's comments, oldest first, including the ones Splitwise adds when it changes.
Inputs
- Expense
expensetextRequired - The expense's number, from 'Add expense', 'List expenses' or the trigger.
Outputs
commentslist- The comments, oldest first
countnumber- How many
expense_idnumber- The expense
Example output
{
"comments": [
{
"by": "Alex Kim",
"content": "Receipt is in the shared folder",
"created_at": "2026-10-28T12:05:00Z",
"from_splitwise": false,
"id": 88001
}
],
"count": 1,
"expense_id": 3071209876
}List expenses
List expenses, newest first, in a group or with a friend, between two dates.
Inputs
- Group
grouptext - Only this group's expenses.
- Friend
friendtext - Only expenses with this friend.
- From
dated_afterdate - Only expenses on or after this day.
- Until
dated_beforedate - Only expenses on or before this day.
- How many
limitnumber - How many expenses. Defaults to 20.From 1 to 500.
Outputs
countnumber- How many
expenseslist- The expenses
Example output
{
"count": 1,
"expenses": [
{
"category": "Groceries",
"cost": 48.6,
"created_at": "2026-10-28T12:01:00Z",
"created_by": "Alex Kim",
"currency": "USD",
"date": "2026-10-28T12:00:00Z",
"deleted": false,
"description": "Groceries",
"details": "",
"group_id": 5512,
"id": 3071209876,
"is_payment": false,
"shares": [
{
"name": "Alex Kim",
"owes": 24.3,
"paid": 48.6,
"user_id": 101
},
{
"name": "Sam Lee",
"owes": 24.3,
"paid": 0.0,
"user_id": 102
}
],
"updated_at": "2026-10-28T12:01:00Z",
"you_paid": 48.6,
"your_share": 24.3
}
]
}List friends
List your friends, with what each owes you (positive) or you owe them (negative).
Inputs
None.
Outputs
countnumber- How many
friendslist- Your friends
Example output
{
"count": 1,
"friends": [
{
"balances": [
{
"amount": 24.3,
"currency": "USD"
}
],
"email": "sam@example.com",
"id": 102,
"name": "Sam Lee",
"settled_up": false
}
]
}List groups
List your groups, with who owes whom in each.
Inputs
None.
Outputs
countnumber- How many
groupslist- Your groups
Example output
{
"count": 1,
"groups": [
{
"debts": [
{
"amount": 24.3,
"currency": "USD",
"from": "Sam Lee",
"to": "Alex Kim"
}
],
"id": 5512,
"members": [
{
"id": 101,
"name": "Alex Kim"
},
{
"id": 102,
"name": "Sam Lee"
}
],
"name": "Flat 4B",
"type": "home",
"updated_at": "2026-10-28T12:01:00Z"
}
]
}Restore expense
Bring back a deleted expense.
Inputs
- Expense
expensetextRequired - The expense's number, from 'Add expense', 'List expenses' or the trigger.
Outputs
categorytext- Its category, such as Groceries
costnumber- How much it cost
created_attext- When it was added (ISO 8601)
created_bytext- Who added it
currencytext- Its currency code, such as USD
datetext- When it was spent (ISO 8601)
deletedtrue/false- True if it was deleted
descriptiontext- What it was for
detailstext- Its notes
group_idnumber- Its group; 0 if it isn't in one
idnumber- The expense's number
is_paymenttrue/false- True if it records someone paying someone back
shareslist- Who paid and who owes what
updated_attext- When it last changed (ISO 8601)
you_paidnumber- How much you paid
your_sharenumber- How much of it is yours
Example output
{
"category": "Groceries",
"cost": 48.6,
"created_at": "2026-10-28T12:01:00Z",
"created_by": "Alex Kim",
"currency": "USD",
"date": "2026-10-28T12:00:00Z",
"deleted": false,
"description": "Groceries",
"details": "",
"group_id": 5512,
"id": 3071209876,
"is_payment": false,
"shares": [
{
"name": "Alex Kim",
"owes": 24.3,
"paid": 48.6,
"user_id": 101
},
{
"name": "Sam Lee",
"owes": 24.3,
"paid": 0.0,
"user_id": 102
}
],
"updated_at": "2026-10-28T12:01:00Z",
"you_paid": 48.6,
"your_share": 24.3
}