Skip to main content
POST
/
accounting
/
accounts
cURL
curl --request POST \
  --url https://api.maesn.dev/accounting/accounts \
  --header 'Content-Type: application/json' \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '{
  "balance": 100,
  "class": "ASSET",
  "code": "91",
  "currency": "EUR",
  "debitCreditIndicator": "DEBIT",
  "description": "Business Savings Account",
  "journalCode": "30",
  "name": "Business Bank",
  "number": "0150",
  "parentAccountId": "46",
  "status": "ACTIVE",
  "type": "BANK"
}'
{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 125,
      "perPage": 50,
      "currentPage": 1,
      "totalPages": 3
    }
  },
  "data": {
    "id": "5570042",
    "balance": 100,
    "class": "ASSET",
    "code": "91",
    "createdDate": "2025-05-01T00:00:00Z",
    "currency": "EUR",
    "debitCreditIndicator": "DEBIT",
    "description": "Business Savings Account",
    "name": "Business Bank",
    "number": "0150",
    "parentAccountId": "46",
    "status": "ACTIVE",
    "type": "BANK",
    "updatedDate": "2021-06-01T00:00:00Z"
  }
}

​
Field support per integration

If you’re not using the Interactive Authentication Flow, make sure the query parameter companyId is correctly populated. You can obtain this value by using the GET Companies endpoint available under the Authentication section.
Supported Request Parameters:
​
code
string
required
​
description
string
required
​
type
string
required
Available options: CASH, BANK, CREDIT_CARD, PAYMENT_PROVIDER, ACCOUNTS_RECEIVABLE, PRE_PAYMENT, ACCOUNTS_PAYABLE, VAT, EMPLOYEES_PAYABLE, PREPAID_EXPENSES, ACCRUED_EXPENSES, INCOME_TAX_PAYABLE, FIXED_ASSET, NON_CURRENT_ASSET, DEPRECIATION, INVENTORY, EQUITY, RETAINED_EARNINGS, LONG_TERM_LIABILITY, CURRENT_LIABILITY, OTHER, TAX_PAYABLE, REVENUE, COST_OF_GOODS_SOLD, OTHER_EXPENSE, OVERHEADS, DEPRECIATION, RESEARCH_AND_DEVELOPMENT, EMPLOYEE_COSTS, EMPLOYMENT_COSTS, EXCEPTIONAL_COSTS, EXCEPTIONAL_INCOME, INCOME_TAXES, INTEREST_INCOME, YEAR_END_REFLECTION, INDIRECT_YEAR_END_COSTING, DIRECT_YEAR_END_COSTING
Supported Request Parameters:
​
number
string
required
​
description
string
required
​
status
enum
Available options: ACTIVE, ARCHIVED

Supported Request Fields:
​
balance
number
​
class
string
required
Available options: ASSET, EQUITY, EXPENSE, LIABILITY, REVENUE
​
code
string
required
​
description
string
​
name
string
required
​
status
enum
required
Available options: ACTIVE, ARCHIVED
If you’re not using the Interactive Authentication Flow, make sure the query parameters environmentName and companyId are correctly populated. You can obtain these values by using the GET Companies endpoint available under the Authentication section. Please use the id field as the companyId and the environmentId field as the environmentName.
Supported Request Parameters:
​
code
string
required
​
description
string
​
name
string
required
​
status
enum
Available options: ACTIVE, ARCHIVED
​
type
string
required
Available options: CUSTOMER, PROVIDER, BANK, CASH, CHARGE, REVENUE, CAPITAL, FIXED_ASSET, MANAGEMENT_RESULT, DEPRECIATION_PROVISION, STOCK, RESULT_BALANCE_SHEET, EMPLOYEE, TITLE, CURRENT_ASSETS, BORROWED_CAPITAL, COST, REDUCTION_IN_EXPENSES, NEUTRAL_REVENUE, NEUTRAL_EXPENSES, SALES_DEDUCTION, EXCHANGE_RATE_INCOME, EXCHANGE_RATE_EXPENSE, BALANCE_CARRIED_FORWARD, AGGREGATE_CARRIED_FORWARD, OTHER_BALANCE_SHEET_ACCOUNT, STATISTICAL_BALANCE, STATISTICAL_CONSUMPTION, CURRENT_ASSETS_INPUT_TAX, BORROWED_CAPITAL_OUTPUT_TAX, CUSTOMER_PREPAYMENT, SUPPLIER_PREPAYMENT, CUSTOMER_PREPAYMENT_TAX_INCLUDED, SUPPLIER_PREPAYMENT_TAX_INCLUDED, INPUT_TAX, OUTPUT_TAX, SUPPLIER_RETURNABLE_PACKAGING, CUSTOMER_RETURNABLE_PACKAGING
Supported Request Parameters:
​
balance
number
​
code
string
required
​
currency
enum
Available options (3-letter ISO 4217):
AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYR, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CVE, CZK, DJF, DKK, DOP, DZD, EEK, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GQE, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZM, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SYP, SZL, THB, TJS, TMT, TND, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEB, VND, VUV, WST, XAF, XCD, XDR, XOF, XPF, YER, ZAR, ZMK, ZWR
​
description
string
​
name
string
required
​
number
string
​
status
enum
Available options: ACTIVE, ARCHIVED
​
type
string
required
Available options:
BANK, CURRENT_ASSET, CURRENT_LIABILITY, DEPRECIATION, DIRECT_COSTS, EQUITY, EXPENSE, FIXED_ASSET, INVENTORY, LIABILITY, NON_CURRENT_ASSET, OTHER_INCOME, OVERHEADS, PRE_PAYMENT, REVENUE, SALES, NON_CURRENT_LIABILITY

Headers

​
X-API-KEY
string
required

API key

​
X-ACCOUNT-KEY
string
required

Account key

Query Parameters

​
companyId
string
​
environmentName
string

Body

application/json
​
balance
number
Example:

100

​
class
enum<string>
Available options:
ASSET,
EQUITY,
EXPENSE,
LIABILITY,
REVENUE
Example:

"ASSET"

​
code
string
Example:

"91"

​
currency
enum<string>
Available options:
AED,
AFN,
ALL,
AMD,
ANG,
AOA,
ARS,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
BGN,
BHD,
BIF,
BMD,
BND,
BOB,
BRL,
BSD,
BTN,
BWP,
BYR,
BZD,
CAD,
CDF,
CHF,
CLP,
CNY,
COP,
CRC,
CUC,
CVE,
CZK,
DJF,
DKK,
DOP,
DZD,
EEK,
EGP,
ERN,
ETB,
EUR,
FJD,
FKP,
GBP,
GEL,
GHS,
GIP,
GMD,
GNF,
GQE,
GTQ,
GYD,
HKD,
HNL,
HRK,
HTG,
HUF,
IDR,
ILS,
INR,
IQD,
IRR,
ISK,
JMD,
JOD,
JPY,
KES,
KGS,
KHR,
KMF,
KPW,
KRW,
KWD,
KYD,
KZT,
LAK,
LBP,
LKR,
LRD,
LSL,
LTL,
LVL,
LYD,
MAD,
MDL,
MGA,
MKD,
MMK,
MNT,
MOP,
MRO,
MUR,
MVR,
MWK,
MXN,
MYR,
MZM,
NAD,
NGN,
NIO,
NOK,
NPR,
NZD,
OMR,
PAB,
PEN,
PGK,
PHP,
PKR,
PLN,
PYG,
QAR,
RON,
RSD,
RUB,
SAR,
SBD,
SCR,
SDG,
SEK,
SGD,
SHP,
SLL,
SOS,
SRD,
SYP,
SZL,
THB,
TJS,
TMT,
TND,
TRY,
TTD,
TWD,
TZS,
UAH,
UGX,
USD,
UYU,
UZS,
VEB,
VND,
VUV,
WST,
XAF,
XCD,
XDR,
XOF,
XPF,
YER,
ZAR,
ZMK,
ZWR
Example:

"EUR"

​
debitCreditIndicator
enum<string>
Available options:
DEBIT,
CREDIT
Example:

"DEBIT"

​
description
string
Example:

"Business Savings Account"

​
journalCode
string
Example:

"30"

​
name
string
Example:

"Business Bank"

​
number
string
Example:

"0150"

​
parentAccountId
string
Example:

"46"

​
status
enum<string>
Available options:
ACTIVE,
ARCHIVED
Example:

"ACTIVE"

​
type
enum<string>
Available options:
PAYMENT_PROVIDER,
BANK,
CURRENT,
CURRLIAB,
DEPRECIATN,
DIRECTCOSTS,
EQUITY,
EXPENSE,
FIXED,
INVENTORY,
LIABILITY,
NONCURRENT,
OTHERINCOME,
OVERHEADS,
PREPAYMENT,
REVENUE,
SALES,
TERMLIAB
Example:

"BANK"

Response

200 - application/json
​
meta
object
​
data
object