---
title: "Create an account"
method: POST
path: "/v1/auth/register"
tags: ["auth"]
---

# Create an account

`POST /v1/auth/register`

## Request

- Base URL: `https://api.smartloop.ai`
- URL: `https://api.smartloop.ai/v1/auth/register`
- Auth: none declared

Sends a verification email. With a valid `invite_code` for the same email the account is verified and premium immediately.

## Request body

- object
  - `email` string, email, required
  - `password` string, required
  - `name` string, required
  - `is_premium` boolean, nullable
  - `invite_code` string, nullable

## Response `200`

The new account

- UserRead
  - `id` string, required
  - `email` string, email, required
  - `is_active` boolean, required
  - `is_superuser` boolean, required
  - `is_verified` boolean, required
  - `name` string, nullable, required
  - `notify` boolean, required
  - `is_premium` boolean, required
  - `is_paid` boolean, required
  - `plan` string, required
  - `number_of_tokens_processed` integer, required
  - `capabilities` string[], required
  - `subscription_id` string, nullable, required
  - `subscription_status` string, nullable, required
  - `subscription_cancel_at_period_end` boolean, required
  - `plan_id` string, nullable, required
  - `subscription_current_period_end` string, date-time, nullable, required
  - `default_temperature` number, required
  - `default_memory` boolean, required
  - `onboarded` boolean, required

## Other responses

- `400`: User already exists, the password is too weak, or the invite code is invalid
- `422`: Validation error

---

[API](https://skmtc.dev/smartloop/apis/smartloop-platform-api.md) - [All operations](https://skmtc.dev/smartloop/apis/smartloop-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smartloop/apis/smartloop-platform-api/revisions/17a787eabbe8?raw)