Create a user and account

POST/v1/auth/signup

Creates a user and its account (state pending until an operator approves it) and sends a verification email. Rate limit: 30 requests per 60 s per IP.

Error codes: invalid_email (400), password_too_short (400), password_breached (400), invalid_input (400), email_taken (409), rate_limit_exceeded (429).

Authentication

This operation needs no authentication.

Parameters

This operation takes no parameters.

Request body

required

Content type: application/json

Schema: SignupRequest

{
  "email": "founder@academy.example",
  "password": "correct-horse-battery",
  "preferred_locale": "ar"
}

Responses

Status	Meaning
`201`	User and pending account created.
`400`	The request body or query failed validation. The per-operation description lists the exact `error.code` values.
`409`	The request conflicts with the resource's current state. The per-operation description lists the exact `error.code` values.
`429`	Rate limit exceeded.

Example request

{
  "email": "founder@academy.example",
  "password": "correct-horse-battery",
  "preferred_locale": "ar"
}

Try it

POST

/v1/auth/signup

No authentication

API playground

Send a live request to the Videohati API; this operation needs no authentication.

Final request URLhttps://api.staging.videohati.com/v1/auth/signup

Request body (JSON)