Sign in

v1

latestOpenAPI 3.1.02026-07-26549156879.0 KB
Finance > Account

Creates an Account

Create a ledger account for the company legal_entity. To avoid duplicates use the external_id field to set the ID of the ledger account in the external system.

post/api/2026-07-01/resources/finance/accounts

Request body

namestring

Name of the ledger account

numberstring required

Number of the ledger account

type'equity' | 'non_current_asset' | 'current_asset' | 'bank' | 'non_current_liability' | 'current_liability' | 'expense' | 'income' required

Type of the ledger account

currencystring required

Currency of the ledger account

legal_entity_idstring required

Legal entity ID of the ledger account

external_idstring

Id of the ledger account on the external system. This field is important to avoid having duplicated ledger accounts

Example request

{
  "name": "Bank Account",
  "number": "1000",
  "type": "bank",
  "currency": "EUR",
  "legal_entity_id": "11",
  "external_id": "ext_123"
}

Response

CREATED

idstring required

Unique identifier in factorial for the ledger account

namestring

Name of the ledger account

legal_entity_idstring required

Legal entity ID of the ledger account

numberstring required

Number of the ledger account

disabledboolean required

Whether the ledger account is disabled

type'equity' | 'non_current_asset' | 'current_asset' | 'bank' | 'non_current_liability' | 'current_liability' | 'expense' | 'income' required

Type of the ledger account

external_idstring

Id of the ledger account on the external system

updated_atstring required

Last updated date of the ledger account

Example response

{
  "id": "1",
  "name": "Bank Account",
  "legal_entity_id": "11",
  "number": "1000",
  "type": "bank",
  "external_id": "ext_123",
  "updated_at": "2021-01-01T00:00:00.000Z"
}