Skip to main content
Use this endpoint to create a new ledger account in your tenant. Every account you create must be assigned a currency and a double-entry accounting type — these are immutable after creation, so choose carefully. Once an account exists, you can post journal entries to it and query its balance or statement at any point in time.

​
Endpoint

​
Authorization

Requires an API key with the ACCOUNTS_WRITE scope. Pass your key in the Authorization header using the Bearer scheme.

​
Parameters

​
string
required
A human-readable display name for the account. Must be at least one character long. This value is shown in your dashboard and returned in all account-related responses.
​
string
An optional free-text description that gives additional context for the account. You can use this to document the account’s purpose, owner, or any other relevant metadata.
​
string
required
The ISO 4217 currency code for this account. Accepted values: BRL, USD, MXN, EUR. This field is immutable after the account is created — all entries posted to this account must use the same currency.
​
string
required
The double-entry accounting classification for this account. Accepted values:This field is immutable after the account is created.

​
Request example

​
Response

A successful request returns HTTP 201 Created with the full account object in the response body.
​
string (UUID)
required
The unique identifier assigned to the new account. Store this value — you will use it to post entries and query balance or statement data.
​
string
required
The display name you provided in the request body.
​
string
The description you provided, or null if omitted.
​
string
required
The ISO 4217 currency code you provided.
​
string
required
The accounting type you provided.
​
string
required
DEBIT for ASSET/EXPENSE accounts, CREDIT for LIABILITY/EQUITY/REVENUE accounts — derived from type.
​
string (ISO 8601)
required
Timestamp at which the account was created (server-assigned).

​
Response example

The currency and type fields cannot be changed after an account is created. If you need a different currency or type, create a new account and migrate your entries.
Account names do not need to be unique across your tenant, but using a consistent naming convention (e.g. "Category — Currency") makes it easier to identify accounts in lists and reports.

​
Error codes