---
title: "Register New User"
method: POST
path: "/registerUser"
tags: ["user-back-office-pam-user-controller"]
---

# Register New User

`POST /registerUser`

Registers a new user within your organization on the TECS Platform.

**Flow Overview:**
- Calls Useraccountws.Preregister consumer API.
- Generates an email confirmation code and link.
- Sends a confirmation email to the user.

**Input Parameters:**
- **firstName** (optional): User's first name.
- **lastName** (optional): User's last name.
- **email** (mandatory, unique): User's email address.
- **dateOfBirth** (optional): User's date of birth (format: dd.MM.yyyy).
- **street1** (optional): Primary address line.
- **street2** (optional): Secondary address line.
- **city** (optional): User's city.
- **country** (optional): User's country.
- **zip** (optional): User's postal code.
- **salutation** (optional): User's salutation (e.g., Mr., Ms.).
- **phone** (optional): User's phone number.
- **identificationNumber** (optional): User's identification number.
- **passportNumber** (optional): User's passport number.
- **driverLicenceNumber** (optional): User's driver's license number.
- **state** (optional): User's state or region.
- **login** (optional, unique): User login identifier.

**Required Role:**
- BO_USERMANAGEMENT_REGISTER_USER

**Authentication:**
Supports both Basic (Base64 encoded credentials: ID:password) and Bearer token authentication.

## Headers

- `Authorization` string, required

## Request body

- InputRegisterUser
  - `firstName` string — User's first name.
  - `lastName` string — User's last name.
  - `email` string, email, required — User's email address (must be unique).
  - `dateOfBirth` string — User's date of birth (expected format: dd.MM.yyyy).
  - `street1` string — Primary address line.
  - `street2` string — Secondary address line.
  - `city` string — City where the user resides.
  - `country` string — User's country.
  - `zip` string — Postal code.
  - `salutation` string — User's salutation (e.g., Mr., Ms.).
  - `phone` string — User's phone number.
  - `identificationNumber` string — User's identification number.
  - `passportNumber` string — User's passport number.
  - `driverLicenceNumber` string — User's driver's license number.
  - `state` string — User's state or region.
  - `login` string — User login identifier (should be unique).
  - `module` string — Module identifier (if applicable).
  - `consumerLanguage` string — Preferred language for the user (e.g., 'en').

## Response `200`

User registered successfully.

- OutputRegisterUser
  - `responseCode` integer — Response code (0 indicates success; non-zero indicates an error).
  - `responseMessage` string — Human-readable response message.
  - `consumerId` string — User login or unique user identifier.

---

[API](https://skmtc.dev/bluefin-com/apis/merchant-services.md) · [All operations](https://skmtc.dev/bluefin-com/apis/merchant-services/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bluefin-com/merchant-services/revisions/84e973bef72c/schema)