POST
/
api
/
external
/
v2
/
ledger_accounts
Create a ledger account
curl --request POST \
  --url https://app.pennylane.com/api/external/v2/ledger_accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "number": "512",
  "label": "Secondary Account",
  "vat_rate": "FR_1_05",
  "country_alpha2": "AT"
}'
{
  "id": 124,
  "number": "512",
  "label": "Secondary Account",
  "vat_rate": "any",
  "country_alpha2": "FR",
  "enabled": true
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
​
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.

Example:

"512"

​
label
string
required

Ledger Account's label

Example:

"Secondary Account"

​
vat_rate
enum<string>
Available options:
FR_1_05,
FR_1_75,
FR_09,
FR_21,
FR_40,
FR_50,
FR_55,
FR_60,
FR_65,
FR_85,
FR_92,
FR_100,
FR_130,
FR_15_385,
FR_160,
FR_196,
FR_200,
AD_10,
AD_45,
AD_95,
AT_100,
AT_130,
AT_200,
BE_60,
BE_120,
BE_210,
BG_90,
BG_200,
CH_25,
CH_37,
CH_77,
CH_26,
CH_38,
CH_81,
CY_30,
CY_50,
CY_90,
CY_190,
CZ_100,
CZ_120,
CZ_150,
CZ_210,
DE_70,
DE_190,
DK_250,
EE_90,
EE_200,
EE_220,
EE_240,
ES_40,
ES_100,
ES_210,
FI_100,
FI_140,
FI_240,
FI_255,
GB_50,
GB_200,
GR_60,
GR_130,
GR_240,
HR_50,
HR_130,
HR_250,
HU_50,
HU_180,
HU_270,
IE_48,
IE_90,
IE_135,
IE_210,
IE_230,
IT_40,
IT_50,
IT_100,
IT_220,
LT_50,
LT_90,
LT_210,
LU_30,
LU_70,
LU_80,
LU_120,
LU_130,
LU_140,
LU_160,
LU_170,
LV_50,
LV_120,
LV_210,
MC_09,
MC_21,
MC_55,
MC_85,
MC_100,
MC_200,
MT_50,
MT_70,
MT_180,
MU_150,
NL_90,
NL_210,
PL_50,
PL_80,
PL_230,
PT_60,
PT_130,
PT_160,
PT_230,
RO_50,
RO_90,
RO_190,
SE_60,
SE_120,
SE_250,
SI_50,
SI_95,
SI_220,
SK_100,
SK_190,
SK_200,
SK_230,
NO_120,
NO_150,
NO_250,
DE_70_BU0002,
DE_190_BU0003,
DE_70_BU0008,
DE_190_BU0009,
DE_intracom_70_BU0012,
DE_intracom_190_BU0013,
exempt,
DE_intracom_exempt_BU0011,
DE_intracom_exempt_BU0047,
DE_exempt_BU0001,
DE_exempt_BU0181,
DE_exempt_BU0490,
intracom_21,
intracom_55,
intracom_85,
intracom_100,
crossborder,
DE_intracom_70_BU0018,
DE_intracom_190_BU0019,
DE_intracom_190_BU0506,
extracom,
DE_extracom_BU0173,
DE_extracom_BU0191,
DE_extracom_190_BU0511,
FR_85_construction,
FR_100_construction,
FR_200_construction,
DE_exempt_construction_BU0046,
DE_70_construction_BU0091,
DE_190_construction_BU0094,
DE_190_construction_BU0526,
any,
mixed
​
country_alpha2
enum<string>
Available options:
AT,
BE,
BG,
CY,
CZ,
DE,
DK,
EE,
ES,
FI,
FR,
GR,
HR,
HU,
IE,
IT,
LT,
LU,
LV,
MT,
NL,
PL,
PT,
RO,
SE,
SI,
SK,
GB,
MC,
CH,
AD,
MU,
NO,
any

Response

Returns the created ledger account

​
id
integer
required
Example:

124

​
number
string
required
Example:

"512"

​
label
string
required
Example:

"Secondary Account"

​
vat_rate
string
required

Ledger Account's VAT rate in percentage

Example:

"any"

​
country_alpha2
string
required

Ledger Account's country code (alpha2)

Example:

"FR"

​
enabled
boolean
required
Example:

true