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

# Create account

`POST /accounts`

## Request

- Base URL: `https://api.quiva.ai`
- URL: `https://api.quiva.ai/accounts`
- Auth: none required
- TypeScript: <https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/docs/accounts/post.ts> (a function with typed inputs; its response is checked against the schema)

- Creates a new account and a user if the provided email does not exist on the system.
- Associates the user with the account with root privileges.
- Sends an email to the user to verify their email address if the email is not already verified on the system.
- A user can be a member of any number of accounts but they can be a root of at most one account.

## Request body

- CreateAccountRequest
  - `name` string, required: Account name that members of the account will be using when signing in. It is case-insensitive. Heading and trailing spaces are trimmed
  - `root_first_name` string: Root user first name
  - `root_last_name` string: Root user last name
  - `root_email` string, email, required: Root user email. A user is not allowed to use the same email as a root email for multiple accounts.
  - `password` string, password, required: Root user password. It has to be a new password if the user is new to the system. If the user exists, they must provide their current password. New password requirements: - Minimum length: 8 characters - Must contain at least one uppercase letter - Must contain at least one lowercase letter - Must contain at least one digit (number) - Must contain at least one special character (punctuation or symbol) - Maximum length: 99 characters
  - `country` string: Country
  - `company_name` string: Company name
  - `address` string: Company address
  - `website` string: Company website
  - `phone_number` string: Company phone number

## Response `200`

Account created successfully

- object
  - `data` object, required
    - `email_confirmed` boolean

## Other responses

- `400`: Bad request

## Changes

- **2025-06-12** `4979dfd00eda`: 1 warning, 1 info
  - removed the optional property `email_confirmed` from the response with the `200` status
  - added the required property `data` to the response with the `200` status

[Operation history](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/changes/accounts/post.md)

---

[API](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway.md) - [All operations](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/revisions/700eb1ace61a?raw)