---
title: "Create a user with a registration code"
method: POST
path: "/v1/user/signup/registration_code"
tags: ["user"]
---

# Create a user with a registration code

`POST /v1/user/signup/registration_code`

Wise uses email address as unique identifier for users. If email is new (there is no active user already) then a new user will be created.

When you are submitting an email which already exists amongst our users then you will get a warning that "You're already a member. Please login". If user already exists then you need to redirect to "Get user authorization" webpage.

## Headers

- `X-External-Correlation-Id` string, uuid

## Request body

- object
  - `email` string, email, required — New user's email address.
  - `registrationCode` string, required — Randomly generated registration code that is unique to this user and request. At least 32 characters long. You need to store registration code to obtain access token on behalf of this newly created user in next step. Please apply the same security standards to handling registration code as if it was a password.
  - `language` string — User default language for UI and email communication. Allowed values: EN, US, PT, ES, FR, DE, IT, JA, RU, PL, HU, TR, RO, NL, HK. Default value: EN.

## Response `200`

OK - User is created successfully.

- User — Represents a Wise user account.
  - `id` integer — User ID.
  - `name` string, nullable — User's full name.
  - `email` string — User's email.
  - `active` boolean — If user is active or not.
  - `details` object, nullable — User details.
    - `firstName` string — User's first name.
    - `lastName` string — User's last name.
    - `phoneNumber` string — Phone number.
    - `dateOfBirth` string, date — Date of birth (YYYY-MM-DD).
    - `occupation` string — Person's occupation.
    - `avatar` string — Link to person avatar image.
    - `primaryAddress` integer — Address object ID to use in addresses endpoints.
    - `address` object — User's address.
      - `countryCode` string — Address country code in 2 digits. "US" for example.
      - `firstLine` string — Address first line.
      - `postCode` string — Address post code.
      - `city` string — Address city name.
      - `state` string — Address state code. Required if country is US, CA, AU, or BR.
      - `occupation` string — User occupation. Required for US, CA, JP.

## Other responses

- `409` — Conflict - User already exists.
- `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

---

[API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/versions/4907a1d269ab/schema)