Skip to main content
POST
/
consumers
/
{consumer_id}
/
accounting
/
accounts
Create ledger account
curl --request POST \
  --url https://api.chift.eu/consumers/{consumer_id}/accounting/accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "number": "<string>"
}'
{
  "number": "<string>",
  "name": "<string>",
  "active": true,
  "type": "bank"
}

Authorizations

​
Authorization
string
header
required

This access token needs to be included in each of your request to the Chift API.

Path Parameters

​
consumer_id
string<uuid>
required

Query Parameters

​
folder_id
string | null

Id of the accounting folder instance. A folder represents a legal entity within the system. Required when the multiple folders feature is enabled.

Body

application/json
​
name
string
required

Name or label of the ledger account as it appears in the accounting system.

Minimum length: 1
​
number
string
required

The account number in the chart of accounts. Must be unique within the accounting folder. In some countries (e.g., France, Belgium, Spain), the number structure is constrained by local accounting rules and must follow official charts of accounts (e.g., Plan Comptable Général).

Minimum length: 3

Response

Successful Response

​
number
string
required

The account number in the chart of accounts. Must be unique within the accounting folder. In some countries (e.g., France, Belgium, Spain), the number structure is constrained by local accounting rules and must follow official charts of accounts (e.g., Plan Comptable Général).

​
name
string
required

Name or label of the account as it appears in the accounting system. This is typically used for internal referencing and identification of the account.

​
active
boolean | null
default:true

Flag indicating whether the account is active. If True, the account is active and can be used in transactions. If False, the account is inactive and cannot be used for transactions.

​
type
enum<string> | null

Represents the functional type of the ledger account, used to support common accounting operations such as payments, invoicing, tax handling, and reporting. The type here is more operational and aligned with how accounts are actually used in day-to-day processes (e.g., tracking receivables, recording VAT, handling bank transactions)

Available options:
bank,
cash,
other_financial,
receivable,
payable,
income,
expense,
vat,
other
⌘I