---
title: "Creates an account with an admin user."
method: POST
path: "/account/v1/accounts"
tags: ["Account"]
---

# Creates an account with an admin user.

`POST /account/v1/accounts`

## Request

- Base URL: `https://api.apaleo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.apaleo.com/account/v1/accounts`
- Auth: OAuth 2
  - Implicit: `https://identity.apaleo.com/connect/authorize`
  - Scopes: `account.create`

Use this call to create a new account.<br>You must have this scope: 'account.create'.

## Headers

- `Idempotency-Key` string

## Request body

- CreateAccountModel
  - `code` string, nullable: The code for the account that can be shown in reports and table views. If not set, random one will be generated
  - `name` string, required: The name for the account, which usually should be the company name
  - `description` string, nullable: The description for the account
  - `defaultLanguage` string, required: The default language code for the account
  - `logoUrl` string, nullable: The URL of the account logo
  - `type` 'Trial' | 'Live' | 'Suspended' | 'Development', required: Set the type of the account
  - `location` CreateAddressModel
    - `addressLine1` string, required
    - `addressLine2` string, nullable
    - `postalCode` string, required
    - `city` string, required
    - `regionCode` string, nullable: The ISO 3166-2 code
    - `countryCode` string, required: The country code, in ISO 3166-1 alpha-2 code

## Response `201`

Creation of the new account was successful.

- AccountCreatedModel
  - `code` string, required: Account code

## Other responses

- `400`: Bad request.
- `401`: You are unauthorized.
- `403`: Forbidden.
- `404`: The Request-URI could not be found.
- `415`: Unsupported media type.
- `422`: Validation errors in the request body or query params.
- `499`: Client closed request.
- `500`: An unexpected error occurred.
- `503`: The server is currently unavailable. Please try later.

---

[API](https://skmtc.dev/apaleo/apis/apaleo-account-api.md) - [All operations](https://skmtc.dev/apaleo/apis/apaleo-account-api/llms.txt) - [OpenAPI document](https://skmtc.dev/apaleo/apis/apaleo-account-api/revisions/8fbc9ab84376?raw)