---
title: "Signup User"
method: POST
path: "/v1/users/auth/register"
tags: ["Users"]
---

# Signup User

`POST /v1/users/auth/register`

## Request

- Base URL: `https://api.fettle.sh` (the document declares no server; this is the origin it was published from)
- URL: `https://api.fettle.sh/v1/users/auth/register`
- Auth: none declared

Create a new user account. Optionally name the workspace to create, or
pass an invite token to join the inviting organization instead.

Requires a Cloudflare Turnstile token in the
`X-Turnstile-Token` header when bot protection is enabled.

## Headers

- `X-Turnstile-Token` string, nullable

## Request body

- CreateUserModel
  - `first_name` string, required
  - `last_name` string, required
  - `email` string, email, required
  - `password` string, required
  - `organization_name` string, nullable
  - `invite_token` string, nullable

## Response `201`

Successful Response

- UserProfileViewModel
  - `id` string, uuid, required
  - `first_name` string, required
  - `last_name` string, required
  - `role` 'admin' | 'editor' | 'viewer', required
  - `email` string, email, required
  - `is_verified` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fettle/apis/fettle-sh.md) · [All operations](https://skmtc.dev/fettle/apis/fettle-sh/llms.txt) · [OpenAPI document](https://skmtc.dev/fettle/apis/fettle-sh/revisions/f32c8a18606f?raw)