v5

latestOpenAPI 3.1.02026-07-262421791.5 MB
user

Create a user with a 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.

post/v1/user/signup/registration_code

Headers

X-External-Correlation-Idstring uuid

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Request body

emailstring email required

New user's email address.

registrationCodestring 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.

languagestring

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.

Example request

{
  "email": "user@email.com",
  "registrationCode": "a]#Et6(yLW@mq4Ky_+EAjXxpHGq7*&lr",
  "language": "EN"
}

Response

OK - User is created successfully.

idinteger

User ID.

namestring nullable

User's full name.

emailstring

User's email.

activeboolean

If user is active or not.

Example response

{
  "id": 101,
  "name": "Example Person",
  "email": "person@example.com",
  "active": true,
  "details": {
    "firstName": "Example",
    "lastName": "Person",
    "phoneNumber": "+37111111111",
    "dateOfBirth": "1977-01-01",
    "avatar": "https://lh6.googleusercontent.com/photo.jpg",
    "primaryAddress": 111,
    "address": {
      "countryCode": "EE",
      "firstLine": "Road 123",
      "postCode": "11111",
      "city": "Tallinn"
    }
  }
}