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

# Create an account

`POST /account`

Creates a new account.

## Request body

- AccountCreate
  - `name` string, required — The name of the account.
  - `slug` string, required — The slug of the account.
  - `organization_id` integer, required — The ID of the organization that owns this account.
  - `status` 'active' | 'inactive', required — The status of the account.

## Response `201`

The account was created.

- Account
  - `id` integer, required — A system-wide unique ID for the account.
  - `name` string, required — The account name.
  - `slug` string, required — An organization-wide unique slug for the account.
  - `organization_id` integer, required — The ID of the organization that owns this account.
  - `status` 'active' | 'inactive' | 'deleted', required — The status of the account. The `deleted` value is only returned in responses to `GET /account/{id}?show_deleted=true` for accounts that have been soft-deleted; it cannot be set via create or update.
  - `deleted_at` string, date-time, nullable — The timestamp at which the account was soft-deleted, or `null` if the account is still active. Only populated in responses to `GET /account/{id}?show_deleted=true`.
  - `metadata` MetadataComponent — The metadata loaded via the metadata catalog API.
    - `key` string — The key of the metadata.
    - `value` string — The value of the metadata.
    - `additional_properties` object — Additional metadata properties, including schemas and tags.
      - `schemas` object[] — The JSON schemas of the metadata.
      - `tags` object[] — Tags associated with the metadata.
        - `key` string
        - `value` string

## Other responses

- `4XX` — Client error responses due to invalid input or missing parameters.
- `5XX` — Internal server error due to an unexpected issue.

---

[API](https://skmtc.dev/nullplatform/apis/nullplatform-api.md) · [All operations](https://skmtc.dev/nullplatform/apis/nullplatform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nullplatform/nullplatform-api/revisions/1c4ea154b159/schema)