Skip to main content
POST
/
accounts
Create an account for a company
curl --request POST \
  --url https://openapi.pleo.io/v1/accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountNumber": "<string>",
  "name": "<string>",
  "taxCodeId": "<string>",
  "accountCategoryId": "<string>",
  "hidden": true
}
'
{
  "id": "<string>",
  "name": "<string>",
  "accountCategoryId": "<string>",
  "hidden": true,
  "accountNumber": "<string>",
  "taxCodeId": "<string>"
}

Authorizations

Authorization
string
header
required

Open API Bearer token

Body

application/json
accountNumber
string

Account number

name
string

Description of this account

taxCodeId
string

unique Tax Code ID

accountCategoryId
string

unique Category ID of the account

hidden
boolean

Is the account hidden/archived for the user

Response

An account has been created

id
string
required

The unique UUID identifier of the account

name
string
required

Description of this account

accountCategoryId
string
required

unique Category ID of the account

hidden
boolean
required

Is the account hidden/archived for the user

accountNumber
string

Account number

taxCodeId
string

unique Tax Code ID