---
title: "Create a finance account"
method: POST
path: "/groups/{groupId}/finance/assets"
tags: ["Legacy (v1-compat)"]
---

# Create a finance account

`POST /groups/{groupId}/finance/assets`

## Request

- Base URL: `https://whatareyoudo.ing/api/v1`
- URL: `https://whatareyoudo.ing/api/v1/groups/{groupId}/finance/assets`
- Auth: HTTP bearer

## Path parameters

- `groupId` string, uuid, required

## Request body

- CompatCreateAssetRequest
  - `name` string, required
  - `type` 'cash' | 'bank' | 'card' | 'savings' | 'other', required
  - `openingBalance` number
  - `openingBalanceMinor` string: issue #63: exact alternative to openingBalance -- wins when present
  - `currency` string, required

## Response `201`

Created

- CompatAsset
  - `id` string, uuid, required
  - `group_id` string, uuid, required
  - `name` string, required
  - `type` 'cash' | 'bank' | 'card' | 'savings' | 'other', required
  - `currency` string, required
  - `opening_balance` number, required
  - `balance` number, required
  - `opening_balance_minor` string, required: issue #63: exact integer minor-units mirror
  - `balance_minor` string, required: issue #63: exact integer minor-units mirror
  - `can_edit` boolean: Whether the caller may change or remove it: its creator, or the group's owner/admin (never an admin of a system group). Present on list responses.

---

[API](https://skmtc.dev/whatareyoudo/apis/whatcha-api.md) · [All operations](https://skmtc.dev/whatareyoudo/apis/whatcha-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whatareyoudo/apis/whatcha-api/revisions/48dd8a54abea?raw)