v1

latestOpenAPI 3.1.02026-08-04103211436.0 KB

AccountingAccounts

Update accounting account

Updates the active status, type, name, collective flag, additional info or attributes of an accounting account identified by accountingCode. Updating an accountingCode that does not match any existing account returns 200 without creating or changing anything — no 404 is raised. Sending an empty additionalInfo object leaves any previously stored metadata unchanged. Entries in attributes with an empty or missing customId or value are silently discarded.

patch/accountingaccounts/{companyId}/{accountingCode}

Path parameters

accountingCodestring required

companyIdstring required

Request body

activeboolean nullable

Whether the accounting account is active.

type'banks' | 'analytics' | 'accountings'

accountingNamestring nullable

Display name of the accounting account.

collectiveboolean nullable

Whether this is a collective (grouping) accounting account rather than an individual one.

additionalInfoobject nullable

Free-form key/value metadata to attach to the account. Sending an empty object leaves any previously stored metadata unchanged instead of clearing it.

Example request

{
  "accountingName": "Bank account - Santander EUR",
  "attributes": [
    {
      "customId": "cost-center",
      "value": "Marketing",
      "valueCustomId": "cc-marketing"
    }
  ]
}

Response

Successful Response

idstring required

Embat resource ID

accountingCodestring required

Client-provided accounting code.

Example response

{
  "accountingCode": "430001"
}