Sign up a new user

POST

/api/auth/signup

Create an account. Returns a session if email auto-confirm is on, otherwise a user with email_confirmation_required=true (a confirmation email is sent).

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Created

Bodyapplication/json

🟠409

🟠400BadRequest

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/api/auth/signup' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email": "user@example.com",
    "password": "stringst",
    "metadata": {}
}'

Response Example

201 - Example 1

{
    "access_token": "string",
    "refresh_token": "string",
    "token_type": "bearer",
    "expires_in": 0,
    "expires_at": 0,
    "user": {}
}

Modified at 2026-07-08 19:01:40

Lazily migrate a legacy password