---
title: "Create an account type"
method: POST
path: "/v2/accountTypes"
tags: ["Account types"]
---

# Create an account type

`POST /v2/accountTypes`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/accountTypes`
- Auth: HTTP bearer

Create a custom account type with specified permissions.

  ### Usage notes
  - To perform this operation, you must use API credentials owned by a user assigned the Admin account type.
  - Use the permission names from the [/v2/accountTypes/:accountTypeId/permissions](https://help.sigmacomputing.com/reference/list-account-type-permissions) endpoint.
  - **licenseType** depends on the permissions enabled for the account type.

  ### Usage scenarios
  - Create custom account types to define specific permission sets for your organization's users.

## Request body

- object
  - `name` string, required: The name of the account type.
  - `description` string, required: A description of the account type.
  - `permissions` string[], required: An array of permissions to enable for this account type. Use the permission names from the [/v2/accountTypes/:accountTypeId/permissions](https://help.sigmacomputing.com/reference/list-account-type-permissions) endpoint.

## Response `201`

The newly created account type.

- AccountTypesCreateAccountTypeResponse201: The newly created account type.
  - `accountTypeId` string, required: The unique identifier of the account type.
  - `accountTypeName` string, required: The name of the account type.
  - `description` string, required: A human-readable description of the permissions and capabilities provided by this account type.
  - `isCustom` boolean, required: Whether this is a custom account type created by the organization (true) or a default Sigma account type (false).
  - `licenseType` string, required: The license type of the account type.

---

[API](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api.md) - [All operations](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/revisions/fb6036208c49?raw)