# Create a new user

**POST /apps/{appId}/users**

Onboard a new user to the banking platform using your unique App ID


## Servers
- Sandbox - Banking Operations: https://bank.bank.place (Sandbox - Banking Operations)
- Sandbox - Authentication: https://auth.bank.place (Sandbox - Authentication)


## Authentication methods
- Bearer auth


## Parameters

### Path parameters
- **appId** (integer)
  App ID


### Body: application/json (object)

- **email** (string(email))
  User email address
- **sumsubToken** (string)
  Optional Sumsub token for reusable KYC
- **userType** (string)
  User type


## Responses
### 201
User created successfully

#### Body: application/json (object)
- **email** (string)
  User email address
- **id** (integer)
  User ID - use this for subsequent API calls

### 400
Invalid request

#### Body: application/json (object)
- **errorCode** (string)
  Error code
- **message** (string)
  Error message

### 401
Unauthorized

#### Body: application/json (object)
- **errorCode** (string)
  Error code
- **message** (string)
  Error message


[Powered by Bump.sh](https://bump.sh)