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

# Create a new account.

`POST /v1-beta/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 fails if any similar accounts with 
        the same `externalId` and `companyId` already exists in Pleo.

## Response `200`

Request matched existing account.

- DataResponseBookkeepingAccountRestModelV4
  - `data` BookkeepingAccountRestModelV4, 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 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 (e.g. missing required fields).
- `409` — Conflict (account with the same `externalId` exists in Pleo)

---

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