---
title: "Sign up a new user."
method: POST
path: "/v1/auth/signup"
tags: ["Auth"]
---

# Sign up a new user.

`POST /v1/auth/signup`

## Request

- Base URL: `https://api.scalix.world`
- URL: `https://api.scalix.world/v1/auth/signup`
- Auth: HTTP bearer

Creates a new end-user account and returns auth tokens plus the created user.

## Request body

- SignUpRequest: New-account signup payload.
  - `email` string, email, required
  - `password` string, required
  - `data` object, nullable: Arbitrary user metadata to attach to the account.
  - `captcha_token` string, nullable

## Response `201`

Account created

- AuthResponse: Authentication tokens plus the authenticated user.
  - `access_token` string, required
  - `refresh_token` string, required
  - `expires_in` integer, required
  - `expires_at` string, date-time, required
  - `token_type` string, required
  - `user` User, required: An end-user account.
    - `id` string, uuid, required
    - `email` string, email, required
    - `phone` string, nullable
    - `email_confirmed_at` string, date-time, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `last_sign_in_at` string, date-time, nullable
    - `user_metadata` object, required
    - `app_metadata` object, required

## Other responses

- `401`: Missing or invalid API key
- `409`: Email already exists
- `429`: Too many signups from this IP
- `500`: Internal error

---

[API](https://skmtc.dev/scalix/apis/scalix-cloud-api.md) · [All operations](https://skmtc.dev/scalix/apis/scalix-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scalix/apis/scalix-cloud-api/revisions/2c04ca0a90bb?raw)