---
title: "Register new account"
method: POST
path: "/auth/signup"
tags: ["Auth"]
---

# Register new account

`POST /auth/signup`

## Request

- Base URL: `https://orbitus.netcorecloud.com`
- URL: `https://orbitus.netcorecloud.com/auth/signup`
- Auth: none required

Creates a client and admin user. Returns JWT immediately.

## Request body

- SignupRequest
  - `accountName` string, required: Unique account name.
  - `fullName` string, required
  - `email` string, email, required: Unique across all users (case-insensitive).
  - `password` string, password, required

## Response `200`

Account created; JWT returned.

- LoginResponse
  - `token` string: JWT access token (15-minute lifetime).
  - `refresh_token` string: Refresh token (7-day lifetime).
  - `refresh_expires_at` string, date-time
  - `client_id` integer
  - `clients` ClientSummary[]
    - `client_id` integer
    - `clientname` string
    - `status` 'active' | 'inactive'
  - `is_parent` boolean
  - `user` UserProfile
    - `id` integer
    - `username` string
    - `email` string, email
    - `full_name` string
    - `role` 'admin' | 'viewer'
    - `client_id` integer
    - `two_factor_enabled` boolean

## Other responses

- `400`: Validation error (duplicate account name or email).

---

[API](https://skmtc.dev/netcorecloud/apis/orbit-router.md) - [All operations](https://skmtc.dev/netcorecloud/apis/orbit-router/llms.txt) - [OpenAPI document](https://skmtc.dev/netcorecloud/apis/orbit-router/revisions/680f0a8ab1a3?raw)
