# Splitwise

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

App · 14 actions. Web page: https://docs.lodol.com/docs/integrations/splitwise

## Actions

### Add expense

Add an expense, split equally in a group or between you and a friend. Splitwise tells the others.

**Inputs**

- Description (`description`, text, required): What it was for, such as Groceries.
- Amount (`cost`, number, required): How much it cost, such as 48.60. At least 0.01.
- Group (`group`, text): The group to split it in, equally. Or pick a friend instead.
- Friend (`friend`, text): Instead of a group, the friend to split it with, half each.
- Paid by (`paid_by`, text): With a friend, who paid. Defaults to you. One of: `me` (I paid), `friend` (My friend paid). Default: `me`.
- Currency (`currency_code`, text): Its currency, such as EUR. Defaults to your default currency.
- Date (`date`, date): When it was spent. Defaults to today.
- Notes (`details`, text): Notes about it.
- Repeats (`repeat`, text): 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**

- `category` (text): Its category, such as Groceries
- `cost` (number): How much it cost
- `created_at` (text): When it was added (ISO 8601)
- `created_by` (text): Who added it
- `currency` (text): Its currency code, such as USD
- `date` (text): When it was spent (ISO 8601)
- `deleted` (true/false): True if it was deleted
- `description` (text): What it was for
- `details` (text): Its notes
- `group_id` (number): Its group; 0 if it isn't in one
- `id` (number): The expense's number
- `is_payment` (true/false): True if it records someone paying someone back
- `shares` (list): Who paid and who owes what
- `updated_at` (text): When it last changed (ISO 8601)
- `you_paid` (number): How much you paid
- `your_share` (number): How much of it is yours

**Example output**

```json
{
  "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 (`expense`, text, required): The expense's number, from 'Add expense', 'List expenses' or the trigger.
- Description (`description`, text): A new description. Leave empty to keep it.
- Amount (`cost`, number): A new amount. Leave empty to keep it. At least 0.01.
- Date (`date`, date): A new date. Leave empty to keep it.
- Notes (`details`, text): New notes. Leave empty to keep them.

**Outputs**

- `category` (text): Its category, such as Groceries
- `cost` (number): How much it cost
- `created_at` (text): When it was added (ISO 8601)
- `created_by` (text): Who added it
- `currency` (text): Its currency code, such as USD
- `date` (text): When it was spent (ISO 8601)
- `deleted` (true/false): True if it was deleted
- `description` (text): What it was for
- `details` (text): Its notes
- `group_id` (number): Its group; 0 if it isn't in one
- `id` (number): The expense's number
- `is_payment` (true/false): True if it records someone paying someone back
- `shares` (list): Who paid and who owes what
- `updated_at` (text): When it last changed (ISO 8601)
- `you_paid` (number): How much you paid
- `your_share` (number): How much of it is yours

**Example output**

```json
{
  "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 (`expense`, text, required): The expense's number, from 'Add expense', 'List expenses' or the trigger.
- Comment (`content`, text, required): What to say.

**Outputs**

- `content` (text): What it says
- `expense_id` (number): The expense
- `id` (number): The comment's number

**Example output**

```json
{
  "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 (`name`, text, required): What to call it, such as Lisbon trip.
- Type (`group_type`, text): What it's for. Defaults to other. One of: `trip`, `home`, `couple`, `other`. Default: `other`.

**Outputs**

- `debts` (list): Who owes whom, simplified
- `id` (number): The group's number
- `members` (list): Its members
- `name` (text): Its name
- `type` (text): trip, home, couple or other
- `updated_at` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "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 (`expense`, text, required): The expense's number, from 'Add expense', 'List expenses' or the trigger.

**Outputs**

- `deleted` (true/false): True once deleted
- `id` (number): The expense's number

**Example output**

```json
{
  "deleted": true,
  "id": 3071209876
}
```

### Delete group

Delete a group and its expenses. Splitwise's website can restore it.

**Inputs**

- Group (`group`, text, required): The group to delete.

**Outputs**

- `deleted` (true/false): True once deleted
- `id` (number): The group's number

**Example output**

```json
{
  "deleted": true,
  "id": 5512
}
```

### Get expense

Get one expense: its cost, who paid and who owes what.

**Inputs**

- Expense (`expense`, text, required): The expense's number, from 'Add expense', 'List expenses' or the trigger.

**Outputs**

- `category` (text): Its category, such as Groceries
- `cost` (number): How much it cost
- `created_at` (text): When it was added (ISO 8601)
- `created_by` (text): Who added it
- `currency` (text): Its currency code, such as USD
- `date` (text): When it was spent (ISO 8601)
- `deleted` (true/false): True if it was deleted
- `description` (text): What it was for
- `details` (text): Its notes
- `group_id` (number): Its group; 0 if it isn't in one
- `id` (number): The expense's number
- `is_payment` (true/false): True if it records someone paying someone back
- `shares` (list): Who paid and who owes what
- `updated_at` (text): When it last changed (ISO 8601)
- `you_paid` (number): How much you paid
- `your_share` (number): How much of it is yours

**Example output**

```json
{
  "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 (`group`, text, required): The group.

**Outputs**

- `debts` (list): Who owes whom, simplified
- `id` (number): The group's number
- `members` (list): Its members
- `name` (text): Its name
- `type` (text): trip, home, couple or other
- `updated_at` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "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_currency` (text): Your default currency
- `email` (text): Your email address
- `id` (number): Your user number
- `name` (text): Your name

**Example output**

```json
{
  "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 (`expense`, text, required): The expense's number, from 'Add expense', 'List expenses' or the trigger.

**Outputs**

- `comments` (list): The comments, oldest first
- `count` (number): How many
- `expense_id` (number): The expense

**Example output**

```json
{
  "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 (`group`, text): Only this group's expenses.
- Friend (`friend`, text): Only expenses with this friend.
- From (`dated_after`, date): Only expenses on or after this day.
- Until (`dated_before`, date): Only expenses on or before this day.
- How many (`limit`, number): How many expenses. Defaults to 20. From 1 to 500.

**Outputs**

- `count` (number): How many
- `expenses` (list): The expenses

**Example output**

```json
{
  "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**

- `count` (number): How many
- `friends` (list): Your friends

**Example output**

```json
{
  "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**

- `count` (number): How many
- `groups` (list): Your groups

**Example output**

```json
{
  "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 (`expense`, text, required): The expense's number, from 'Add expense', 'List expenses' or the trigger.

**Outputs**

- `category` (text): Its category, such as Groceries
- `cost` (number): How much it cost
- `created_at` (text): When it was added (ISO 8601)
- `created_by` (text): Who added it
- `currency` (text): Its currency code, such as USD
- `date` (text): When it was spent (ISO 8601)
- `deleted` (true/false): True if it was deleted
- `description` (text): What it was for
- `details` (text): Its notes
- `group_id` (number): Its group; 0 if it isn't in one
- `id` (number): The expense's number
- `is_payment` (true/false): True if it records someone paying someone back
- `shares` (list): Who paid and who owes what
- `updated_at` (text): When it last changed (ISO 8601)
- `you_paid` (number): How much you paid
- `your_share` (number): How much of it is yours

**Example output**

```json
{
  "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
}
```
