Create a ledger account

post

https://app.pennylane.com/api/external/v2/ledger_accounts

NEW BEHAVIOR :
The old ledger scope will only work on the old behavior system. As soon as you opt in to the new version, or when the sunset phase starts and you haven't explicitly opted out of the old behavior, the ledger scope will no longer work.
For more details, see our API documentation https://pennylane.readme.io/docs/2026-api-changes-guide for migration instructions.

ℹ️
This endpoint requires one of the following scopes: ledger (DEPRECATED), ledger_accounts:all

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

❗️
NEW BEHAVIOR :
The old ledger scope will only work on the old behavior system. As soon as you opt in to the new version, or when the sunset phase starts and you haven't explicitly opted out of the old behavior, the ledger scope will no longer work.For more details, see our API documentation https://pennylane.readme.io/docs/2026-api-changes-guide for migration instructions. You can use ledger_accounts:all scopes instead.

ℹ️
This endpoint requires one of the following scopes: ledger (DEPRECATED), ledger_accounts:all

Query Params

use_2026_api_changes

boolean

Defaults to true

If you are already using the X-Use-2026-API-Changes header, you can ignore this parameter.

The Pennylane API is introducing important changes, which will be rolled out in three phases: preview, sunset and cleanup.

For new user, please use this parameter with true value to opt in directly to the new version of the API.

Preview phase:
From January 14th to April 7th 2026.
Opt in by setting this attribute to true to test and migrate to the new behavior.

Sunset phase:
From April 8th to June 30th 2026.
The new behavior becomes the default. Set this attribute to false if you need additional time to migrate.

Cleanup phase:
Starting July 1st 2026
The old behavior will no longer be available. You must have migrated by this point.

For more details, see our API documentation https://pennylane.readme.io/docs/2026-api-changes-guide for migration instructions.

Body Params

number

string

required

Ledger Account's number.
If the number starts with 401 (supplier) or 411 (customer) a corresponding supplier or company customer will also be created.

label

string

required

Ledger Account's label

vat_rate

string

enum

country_alpha2

string

enum

Responses

201Returns the created ledger account

400Bad request

401Access token is missing or invalid

403Access to this resource forbidden

404The resource was not found

422Unprocessable content