FAfactorialhr
Finance > Account

Updates an Account

Changed on

Update a ledger account.

put/api/2026-10-01/resources/finance/accounts/{id}

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/finance/accounts/{id}
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: finance
    • or API key in header x-api-key

Path parameters

idstring required

Unique identifier in factorial for the ledger account

Request body

idstring required

Unique identifier in factorial for the ledger account

namestring

Name of the ledger account

numberstring

Number of the ledger account

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

Type of the ledger account

currencystring

Currency of the ledger account

legal_entity_idstring

Legal entity ID of the ledger account

external_idstring

Id of the ledger account on the external system

Example request

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

Response

OK

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"
}

Changes