Skip to content

Create a user with a registration code

Request

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.

Security
ClientCredentialsToken
Headers
X-External-Correlation-Idstring, (uuid), <= 36 characters

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

Example:f47ac10b-58cc-4372-a567-0e02b2c3d479
Bodyapplication/jsonrequired
emailstring, (email)required

New user's email address.

Example:"user@email.com"
registrationCodestring, >= 32 charactersrequired

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.

Example:"a]#Et6(yLW@mq4Ky_+EAjXxpHGq7*&lr"
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:"EN"
curl -i -X POST \
  https://api.wise.com/2026Q3/user/signup/registration_code \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-External-Correlation-Id: f47ac10b-58cc-4372-a567-0e02b2c3d479' \
  -d '{
    "email": "user@email.com",
    "registrationCode": "a]#Et6(yLW@mq4Ky_+EAjXxpHGq7*&lr",
    "language": "EN"
  }'

Responses

OK - User is created successfully.

Headers
X-External-Correlation-Idstring, (uuid), <= 36 characters

Echoed back when X-External-Correlation-Id was included in the request. Learn more.

Example:"f47ac10b-58cc-4372-a567-0e02b2c3d479"
x-trace-idstring

Unique trace identifier assigned by Wise. Useful when contacting support about a specific request.

Example:"fba501b6d453b96789f52338f019341f"
Bodyapplication/json
idinteger, (int64)

User ID.

Example:101
namestring or null

User's full name.

Example:"Example Person"
emailstring

User's email.

Example:"person@example.com"
activeboolean

If user is active or not.

Example:true
detailsobject or null

User details.

Response
{
  "id": 12345,
  "name": null,
  "email": "new.user@domain.com",
  "active": true,
  "details": null
}