---
title: "Register new user"
method: POST
path: "/users"
tags: ["User"]
---

# Register new user

`POST /users`

Used to register a new user

## Request body

- RegisterUserRequest
  - `email` string, required — The user's E-Mail address
  - `given_name` string, required — The user's given (first) name
  - `family_name` string, required — The user's family (last) name
  - `invitation_acceptance_secret` string — The labeled acceptance secret from the invitation accept URL. Required (or `invitation_id`, deprecated) if credentials is specified.
  - `invitation_id` string — Deprecated. Use `invitation_acceptance_secret` instead.
  - `company` string — The user's company
  - `country_code` string — The user's country specified as an ISO 3166-1 alpha-2 country code
  - `credentials` object — The user's credentials
    - `bcrypt_hash` string, required
  - `language` 'en' | 'ja' — The user's preferred language specified as a 2-letter language code.

## Response `201`

User registered

## Other responses

- `400` — Invalid or missing parameter
- `409` — User with this email already exists
- `default` — Unknown error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)