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

# Create an account

`POST /api/auth/register`

## Request

- Base URL: `https://cliponit.app`
- URL: `https://cliponit.app/api/auth/register`
- Auth: none required

Creates a user (free plan), opens a 30-day session and seeds a demo video. Returns the session token (also set as the `session` cookie).

## Request body

- object
  - `email` string, email, required
  - `name` string, required
  - `password` string, required

## Response `200`

User + session token (also set as `session` cookie)

- object
  - `user` User, required
    - `id` string, uuid, required
    - `email` string, email, required
    - `name` string, required
    - `avatar_url` string, nullable
    - `locale` string, required
    - `plan` 'free' | 'starter' | 'pro' | 'business', required
    - `onboarded` 0 | 1, required
  - `token` string, required: Session token (64 hex), usable as `Authorization: Bearer <token>` for 30 days

## Other responses

- `400`: Validation error — the message names the field, e.g. `champ subtitles.size invalide : attendu 1..3`

---

[API](https://skmtc.dev/cliponit/apis/cliponit-api.md) · [All operations](https://skmtc.dev/cliponit/apis/cliponit-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cliponit/apis/cliponit-api/revisions/10e3e4327922?raw)