Skip to main content
POST
/
service
/
general-ledger
/
accounts
curl -X POST https://kube.acho.io/service/general-ledger/accounts \
  -H "Authorization: jwt YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "11100",
    "account_number": 11100,
    "account_name": "Cash - Operating",
    "account_type": "Asset",
    "normal_balance": "debit",
    "currency": "USD",
    "balance": 0,
    "opening_balance": 0,
    "is_summary": false,
    "is_inactive": false
  }'

{
  "account_id": "11100",
  "account_number": 11100,
  "account_name": "Cash - Operating",
  "account_type": "Asset",
  "normal_balance": "debit",
  "currency": "USD",
  "balance": 0,
  "opening_balance": 0,
  "is_summary": false,
  "is_inactive": false,
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

​
Request

Create a new account in the chart of accounts.

​
Headers

​
Authorization
string
required
JWT authentication token. Format: jwt YOUR_TOKEN
​
Content-Type
string
required
Must be application/json

​
Body Parameters

​
account_id
string
required
Unique identifier for the account
​
account_number
number
required
Numeric account number for sorting and display
​
account_name
string
required
Display name for the account
​
account_type
string
required
Account classification. One of: Asset, Liability, Equity, Revenue, Expense
​
normal_balance
string
required
Normal balance side. One of: debit, credit
​
currency
string
required
ISO 4217 currency code (e.g., USD, EUR)
​
balance
number
default:"0"
Current account balance
​
opening_balance
number
default:"0"
Opening balance for the account
​
is_summary
boolean
default:"false"
Whether this is a summary/parent account
​
is_inactive
boolean
default:"false"
Whether the account is inactive
curl -X POST https://kube.acho.io/service/general-ledger/accounts \
  -H "Authorization: jwt YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "11100",
    "account_number": 11100,
    "account_name": "Cash - Operating",
    "account_type": "Asset",
    "normal_balance": "debit",
    "currency": "USD",
    "balance": 0,
    "opening_balance": 0,
    "is_summary": false,
    "is_inactive": false
  }'

{
  "account_id": "11100",
  "account_number": 11100,
  "account_name": "Cash - Operating",
  "account_type": "Asset",
  "normal_balance": "debit",
  "currency": "USD",
  "balance": 0,
  "opening_balance": 0,
  "is_summary": false,
  "is_inactive": false,
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}