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

Get started for freeTalk to us