PEpennylane
Ledger Accounts

Update a ledger account

Changed on

Update a ledger account

ℹ️ This endpoint requires the following scope: ledger_accounts:all

put/api/external/v2/ledger_accounts/{id}

Request

  • Base URL
    https://app.pennylane.com
  • URL
    https://app.pennylane.com/api/external/v2/ledger_accounts/{id}
  • Auth
    OAuth 2
    Authorization code: https://app.pennylane.com/oauth/authorize
    Token URL: https://app.pennylane.com/oauth/oauth/token scopes: ledger_accounts:all

Path parameters

idinteger required
Example:234

Ledger Account ID

Headers

X-Company-Idstring
Example:12345

Numeric ID of the company to act on. Required when authenticating with a firm token. Ignored when the token is already bound to a company.

Request body

labelstring

Label that describes the ledger account

letterableboolean

Whether the ledger entries of this ledger account are letterable

Example request

{
  "label": "Capital",
  "letterable": true
}

Response

Returns the updated ledger account

idinteger required
numberstring required
labelstring required
vat_ratestring required

Ledger Account's VAT rate in percentage

country_alpha2string required

Ledger Account's country code (alpha2)

enabledboolean required
typestring required
letterableboolean required
created_atstring date-time required

The time the ledger account has been created

updated_atstring date-time required

The last time the ledger account has been updated

Example response

{
  "id": 124,
  "number": "512",
  "label": "Secondary Account",
  "vat_rate": "any",
  "country_alpha2": "FR",
  "enabled": true,
  "type": "custom",
  "created_at": "2023-08-30T10:08:08.146343Z",
  "updated_at": "2023-08-30T10:08:08.146343Z"
}

Changes