---
title: "Create a new account"
method: POST
path: "/v1/chart-of-accounts"
tags: ["Accounts"]
---

# Create a new account

`POST /v1/chart-of-accounts`

The integration sends a request to this endpoint to create a corresponding account in Pleo for any new record created in the external ERP/accounting system.
The request will fail if an account with the same `externalId` and `companyId` already exists in Pleo.

## Response `200`

Request matched existing account.

- DataResponseBookkeepingAccountRestModelV1
  - `data` BookkeepingAccountRestModelV1, required — Represents an account in Pleo.
    - `archived` boolean, required — Boolean flag used to determine if the account is archived.
    - `code` string, nullable — Account code or number used in the accounting system's chart of accounts.
    - `companyId` string, uuid, required — Pleo's internal identifier of the company the account is associated with.
    - `externalId` string, required — Unique external identifier of the account, assigned in the external ERP/accounting system. Can be the same as code if no other identifier is available.
    - `id` string, uuid, required — Pleo's internal identifier of the account.
    - `metadata` object, nullable — Place for API users to store flexible data.
    - `name` string, required — Name of the account.
    - `taxCodeExternalId` string, nullable — The identifier in **the target system** for the tax code the account is associated with.

## Other responses

- `201` — Account created.
- `400` — Bad request: for example, missing required fields.
- `409` — Conflict: account with the same `externalId` exists in Pleo.

---

[API](https://skmtc.net/pleo/apis/gjoll-api.md) · [All operations](https://skmtc.net/pleo/apis/gjoll-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pleo/gjoll-api/versions/c70cd21dc330/schema)