---
title: "Create a new account"
method: POST
path: "/account"
tags: ["Account"]
---

# Create a new account

`POST /account`

## Request body

- AccountCreateRequestBody — AccountCreateRequestBody
  - `account_name` string, required — Account name
  - `parent_account_id` string — Account ID
  - `primary_billing_group_id` string — Billing group ID

## Response `200`

Response

- AccountCreateResponse — AccountCreateResponse
  - `account` object, required — Account details
    - `access_source` 'descendant_membership' | 'organization_membership' | 'project_membership' | 'team_membership' — Describe the source of the account
    - `account_id` string, required — Account ID
    - `account_name` string, required — Account name
    - `account_owner_team_id` string, required — Team ID
    - `create_time` string, required — Timestamp in ISO 8601 format, always in UTC
    - `features` object — Feature flags
    - `is_account_member` boolean — If true, user is part of a team of this or a parent account
    - `is_account_owner` boolean, required — If true, user is part of the owners team for this account
    - `organization_id` string, required — Organization ID
    - `parent_account_id` string — Account ID
    - `primary_billing_group_id` string, required — Primary billing group ID - deprecated, always null
    - `root_account_id` string, required — Account ID
    - `tenant_id` string — Tenant identifier
    - `update_time` string, required — Timestamp in ISO 8601 format, always in UTC
  - `errors` object[] — List of errors occurred during request processing
    - `message` string, required — Printable error message
    - `more_info` string — URL to the documentation of the error
    - `status` integer, required — HTTP error status code
  - `message` string — Printable result of the request

## Other responses

- `400` — Invalid request parameters
- `403` — Operation not allowed

---

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