Sign in

v5

latestOpenAPI 3.1.02026-07-262421791.5 MB
profile

Create a personal profile

Create a personal profile for the authenticated user. A personal profile represents an individual and is required before creating transfers or business profiles.

{% admonition type="info" %} Use the X-idempotence-uuid header to safely retry requests. If omitted and a profile already exists, the API returns 409 Conflict. You can then retrieve existing profiles via List profiles. {% /admonition %}

Field notes {% .title-4 .m-t-3 %}

  • First and last names are limited to 30 characters each. Truncate if necessary (e.g. when a customer has many middle names).
  • occupations is required for CA, IN, JP, ID, IL, MX, and within the US for the state NM.
  • contactDetails are used for mandatory customer notifications and to help identify your customer when contacting Wise support.
post/v2/profiles/personal-profile

Headers

X-idempotence-uuidstring uuid

Unique idempotency key for the request.

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

firstNamestring required

First name (including middle names).

lastNamestring required

Last name.

preferredNamestring

Preferred first name, if different to the legal first name.

firstNameInKanastring nullable

First name in Katakana. Required for from-JPY personal transfers.

lastNameInKanastring nullable

Last name in Katakana. Required for from-JPY personal transfers.

nationalitystring

3 letter country code (lower case).

dateOfBirthstring required

Date of birth.

externalCustomerIdstring

An external reference identifier mapping the customer of this profile to your system.

Example request

{
  "firstName": "Oliver",
  "lastName": "Wilson",
  "preferredName": "Olivia",
  "address": {
    "addressFirstLine": "50 Sunflower Ave",
    "city": "Phoenix",
    "countryIso3Code": "usa",
    "postCode": "10025",
    "stateCode": "AZ"
  },
  "nationality": "usa",
  "dateOfBirth": "1977-07-01",
  "externalCustomerId": "12345-oliver-wilson",
  "contactDetails": {
    "email": "o.wilson@example.com",
    "phoneNumber": "+3725064992"
  },
  "occupations": [
    {
      "code": "Software Engineer",
      "format": "FREE_FORM"
    }
  ]
}

Response

Created personal profile.

idinteger

Unique profile ID.

type'PERSONAL'

Profile type.

Example response

{
  "id": 30000001,
  "type": "PERSONAL",
  "details": {
    "firstName": "Oliver",
    "lastName": "Wilson",
    "preferredName": "Olivia",
    "address": {
      "addressFirstLine": "50 Sunflower Ave",
      "city": "Phoenix",
      "countryIso3Code": "usa",
      "postCode": "10025",
      "stateCode": "AZ"
    },
    "nationality": "usa",
    "dateOfBirth": "1977-07-01",
    "externalCustomerId": "12345-oliver-wilson",
    "contactDetails": {
      "email": "o.wilson@example.com",
      "phoneNumber": "+3725064992"
    },
    "occupations": [
      {
        "code": "Software Engineer",
        "format": "FREE_FORM"
      }
    ]
  }
}