---
title: "Add Account"
method: POST
path: "/api/net-worth/{user_id}/accounts"
tags: ["Net Worth"]
---

# Add Account

`POST /api/net-worth/{user_id}/accounts`

## Request

- Base URL: `https://api.earmarkiq.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.earmarkiq.app/api/net-worth/{user_id}/accounts`
- Auth: HTTP bearer

Add a manual net worth account.

## Path parameters

- `user_id` string, uuid, required

## Request body

- AppApiNetWorthAccountCreate
  - `account_name` string, required
  - `account_type` 'current' | 'savings' | 'investment' | 'pension' | 'property' | 'crypto' | 'other_asset' | 'credit_card' | 'loan' | 'mortgage' | 'other_debt', required
  - `balance` union
    - number
    - string
  - `currency` string
  - `institution` string, nullable
  - `notes` string, nullable
  - `interest_rate` union
    - number
    - string
  - `monthly_payment` union
    - number
    - string
  - `property_value` union
    - number
    - string
  - `remaining_term_months` integer, nullable
  - `rate_type` string, nullable
  - `fixed_rate_end_date` string, nullable
  - `planned_monthly` union
    - number
    - string

## Response `201`

Successful Response

- AppApiNetWorthAccountResponse
  - `id` string, required
  - `account_name` string, required
  - `account_type` string, required
  - `balance` number, required
  - `currency` string, required
  - `is_manual` boolean, required
  - `is_debt` boolean, required
  - `last_updated` string, required
  - `created_at` string, required
  - `institution` string, nullable
  - `notes` string, nullable
  - `interest_rate` number, nullable
  - `monthly_payment` number, nullable
  - `property_value` number, nullable
  - `remaining_term_months` integer, nullable
  - `rate_type` string, nullable
  - `fixed_rate_end_date` string, nullable
  - `ltv_ratio` number, nullable
  - `remortgage_alert` boolean
  - `remortgage_months_remaining` integer, nullable
  - `source` string, nullable
  - `represented_by_property_id` string, nullable
  - `linked_account_id` string, nullable
  - `linked_investment_account_id` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/earmarkiq/apis/earmark-api.md) · [All operations](https://skmtc.dev/earmarkiq/apis/earmark-api/llms.txt) · [OpenAPI document](https://skmtc.dev/earmarkiq/apis/earmark-api/revisions/4a2c41907105?raw)