FAfactorialhr
Finance > AccountingSetting

Upserts an Accounting setting

Changed on

Upserts an Accounting setting

post/api/2026-10-01/resources/finance/accounting_settings/upsert

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/finance/accounting_settings/upsert
  • 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

Request body

external_idstring

External ID for the accounting setting.

legal_entity_idstring required

ID of the associated Legal Entity.

default_account_for_purchase_invoices_idstring

Default account for purchase invoices.

default_account_for_vendors_idstring

Default account for vendors.

default_account_for_banks_idstring

Default account for banks.

default_account_for_suspense_idstring

Default suspense account.

default_account_for_expenses_idstring

Default account for expenses.

default_account_for_employees_idstring

Default account for employees.

default_account_for_sale_invoices_idstring

Default account for sale invoices.

default_account_for_clients_idstring

Default account for clients.

default_account_for_benefits_idstring

Default account for benefits.

Example request

{
  "external_id": "ext_135",
  "legal_entity_id": "101",
  "default_account_for_purchase_invoices_id": "5001",
  "default_account_for_vendors_id": "5002",
  "default_account_for_banks_id": "5003",
  "default_account_for_suspense_id": "5004",
  "default_account_for_expenses_id": "5005",
  "default_account_for_employees_id": "5006",
  "default_account_for_sale_invoices_id": "5007",
  "default_account_for_clients_id": "5008",
  "default_account_for_benefits_id": "5009"
}

Response

OK

idstring required

Identifier for the AccountingSetting.

external_idstring

External ID for the accounting setting.

company_idstring required

ID of the associated Company.

legal_entity_idstring required

ID of the associated Legal Entity.

updated_atstring required

Timestamp when the accounting setting was last updated.

default_account_for_purchase_invoices_idstring

Default account for purchase invoices.

default_account_for_vendors_idstring

Default account for vendors.

default_account_for_banks_idstring

Default account for banks.

default_account_for_suspense_idstring

Default suspense account.

default_account_for_expenses_idstring

Default account for expenses.

default_account_for_employees_idstring

Default account for employees.

default_account_for_sale_invoices_idstring

Default account for sale invoices.

default_account_for_clients_idstring

Default account for clients.

default_account_for_benefits_idstring

Default account for benefits.

Example response

{
  "id": "1234",
  "external_id": "ext_135",
  "company_id": "1",
  "legal_entity_id": "101",
  "updated_at": "2025-01-01T00:00:00.000Z",
  "default_account_for_purchase_invoices_id": "5001",
  "default_account_for_vendors_id": "5002",
  "default_account_for_banks_id": "5003",
  "default_account_for_suspense_id": "5004",
  "default_account_for_expenses_id": "5005",
  "default_account_for_employees_id": "5006",
  "default_account_for_sale_invoices_id": "5007",
  "default_account_for_clients_id": "5008",
  "default_account_for_benefits_id": "5009"
}

Changes