---
title: "🔒 Create account"
method: POST
path: "/api/v1/account"
tags: ["Account"]
---

# 🔒 Create account

`POST /api/v1/account`

This endpoint is currently in Beta and available for testing. It may contain bugs, and breaking changes can occur at any time without prior notice. We do not recommend using Beta endpoints in production environments. Should you choose to use it in production, you assume full responsibility for any resulting issues.

Creates a single account.

## Request body

- object
  - `accountNumber` string, required — Account number
  - `accountType` string, required — Account type
  - `name` string, required — Account name
  - `description` string, required — Account description
  - `isStandard` boolean — Is standard account

## Response `201`

Created

- object — Account entry
  - `id` string — Account ID
  - `accountNumber` string — Account number
  - `accountType` string — Account type
  - `name` string — Account name
  - `description` string — Account description
  - `isStandard` boolean — Is standard account
  - `deletedAt` string, date-time, nullable — Deleted at timestamp
  - `createdAt` string, date-time — Created at timestamp
  - `updatedAt` string, date-time — Updated at timestamp

## Other responses

- `400` — XGL Problem
- `401` — Unable to authenticate the client
- `403` — Unable to authorize the client
- `409` — IETF RFC 9457 Problem API compliant response
- `415` — Resource representation send in the request is not supported.
- `429` — Too many API calls made.
- `500` — XGL Problem

---

[API](https://skmtc.net/xentral/apis/xentral-api.md) · [All operations](https://skmtc.net/xentral/apis/xentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xentral/xentral-api/revisions/8a27ba392442/schema)