Get started
Integrations
Use cases
API reference
- Accounting
- Overview
- Accounts
- Async Task
- Bills
- Bill Lines
- Bookings
- Booking Proposals
- Contacts
- Customers
- Dimensions
- Expenses
- Files
- Invoices
- Invoice Lines
- Items
- Journals
- Journal Entries
- Offers
- Offer Lines
- Payments
- Payment Terms
- Projects
- Sales Orders
- Sales Order Lines
- Suppliers
- Tax Rates
- Transactions
- Vendor Credits
- Authentication
- Tenant Management
- User
Create account
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 '{
"accountNumber": "account number 1",
"accountSystem": "Account System 1",
"balance": "100",
"bankName": "Bank Name 1",
"bic": "XXXXDE00",
"class": "ASSET",
"code": "code 1",
"currency": "EUR",
"description": "Business Savings Account",
"iban": "DE00000000000000000000",
"importType": "CSV",
"name": "bank account name",
"parentAccountId": "Parent account id",
"status": "ACTIVE",
"type": "BANK"
}'
{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "1",
"accountNumber": "account number 1",
"accountSystem": "account system 1",
"balance": 100,
"bankName": "bank name 1",
"bic": "XXXXDE00",
"class": "ASSET",
"code": "code 1",
"currency": "EUR",
"description": "Business Savings Account",
"iban": "DE00000000000000000000",
"name": "bank account name",
"parentAccountId": "Parent account id",
"status": "ACTIVE",
"type": "BANK",
"updatedDate": "2021-01-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:
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:
Required if type
equals GIRO
.
Available options:
ASSET
Available options (3-letter ISO 4217):
EUR
Required if type
equals GIRO
.
Available options:
ACTIVE
, ARCHIVED
Available options:
GIRO
, PAYMENT_PROVIDER
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:
Available options:
ACTIVE
, ARCHIVED
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:
Available options:
ASSET
, EQUITY
, EXPENSE
, LIABILITY
, REVENUE
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
Available options:
ACTIVE
, ARCHIVED
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
This endpoints allows the creation of both “file import accounts” and “clearing accounts”.
To create “file import accounts”, set the type
equal to BANK
. In such case, the importType
field is required.
To create “clearing accounts” set the type
equal to CURRENT_ASSET
.
Supported Response Fields:
Available options:
CSV
, MT940
,
Available options:
BANK
, CURRENT_ASSET
Body
Response
The response is of type object
.
Was this page helpful?
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 '{
"accountNumber": "account number 1",
"accountSystem": "Account System 1",
"balance": "100",
"bankName": "Bank Name 1",
"bic": "XXXXDE00",
"class": "ASSET",
"code": "code 1",
"currency": "EUR",
"description": "Business Savings Account",
"iban": "DE00000000000000000000",
"importType": "CSV",
"name": "bank account name",
"parentAccountId": "Parent account id",
"status": "ACTIVE",
"type": "BANK"
}'
{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "1",
"accountNumber": "account number 1",
"accountSystem": "account system 1",
"balance": 100,
"bankName": "bank name 1",
"bic": "XXXXDE00",
"class": "ASSET",
"code": "code 1",
"currency": "EUR",
"description": "Business Savings Account",
"iban": "DE00000000000000000000",
"name": "bank account name",
"parentAccountId": "Parent account id",
"status": "ACTIVE",
"type": "BANK",
"updatedDate": "2021-01-01T00:00:00Z"
}
}