Skip to main content
POST
/
api
/
accounts
{
  "name": "Main Wallet",
  "type": "WALLET",
  "currency": "ARS",
  "color": "#10B981",
  "icon": "wallet"
}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Main Wallet",
  "type": "WALLET",
  "currency": "ARS",
  "balance": 0,
  "color": "#10B981",
  "icon": "wallet",
  "targetAmount": null,
  "targetDate": null,
  "isDefault": false,
  "userId": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2026-03-04T10:30:00Z",
  "updatedAt": "2026-03-04T10:30:00Z"
}
Creates a new account for the authenticated user. Accounts can be of type WALLET, SAVINGS, INVESTMENT, or CREDIT_CARD.

Request Body

name
string
required
The name of the accountExample: "Main Wallet", "Vacation Savings"
type
enum
required
The type of accountOptions:
  • WALLET - Cash, Bank, Virtual Wallet (Daily flow)
  • SAVINGS - Goals, Savings (Accumulation)
  • INVESTMENT - Investments
  • CREDIT_CARD - Credit Cards
currency
string
required
The currency code for the accountOptions: ARS, USD, EUR
color
string
Hex color identifier for the accountExample: "#10B981"
icon
string
Icon identifier for the accountDefault: "wallet"
targetAmount
number
Target amount goal (primarily for SAVINGS accounts)Must be at least 1 if provided
targetDate
string
Target date for reaching the goal (primarily for SAVINGS accounts)Format: ISO 8601 date string

Response

id
string
Unique identifier for the account
name
string
Account name
type
string
Account type enum value
currency
string
Currency code
balance
number
Current balance (initialized to 0)
color
string
Hex color code
icon
string
Icon identifier
targetAmount
number | null
Target amount goal
targetDate
string | null
Target date for goal
isDefault
boolean
Whether this is the default account
userId
string
Owner user ID
createdAt
string
Creation timestamp
updatedAt
string
Last update timestamp
{
  "name": "Main Wallet",
  "type": "WALLET",
  "currency": "ARS",
  "color": "#10B981",
  "icon": "wallet"
}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Main Wallet",
  "type": "WALLET",
  "currency": "ARS",
  "balance": 0,
  "color": "#10B981",
  "icon": "wallet",
  "targetAmount": null,
  "targetDate": null,
  "isDefault": false,
  "userId": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2026-03-04T10:30:00Z",
  "updatedAt": "2026-03-04T10:30:00Z"
}

Build docs developers (and LLMs) love