---
title: "Create a personal profile"
method: POST
path: "/v2/profiles/personal-profile"
tags: ["profile"]
---

# Create a personal profile

`POST /v2/profiles/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](/api-reference/profile/profilelist).
{% /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.

## Headers

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

## Request body

- object
  - `firstName` string, required — First name (including middle names).
  - `lastName` string, required — Last name.
  - `preferredName` string — Preferred first name, if different to the legal first name.
  - `firstNameInKana` string, nullable — First name in Katakana. Required for from-JPY personal transfers.
  - `lastNameInKana` string, nullable — Last name in Katakana. Required for from-JPY personal transfers.
  - `address` object, required
    - `addressFirstLine` string, required — First line of address.
    - `city` string, required — City.
    - `countryIso3Code` string, required — 3 letter country code (lower case).
    - `postCode` string — Postal code.
    - `stateCode` string — State code. Required for US, CA, BR and AU addresses.
  - `nationality` string — 3 letter country code (lower case).
  - `dateOfBirth` string, required — Date of birth.
  - `externalCustomerId` string — An external reference identifier mapping the customer of this profile to your system.
  - `contactDetails` object, required
    - `email` string, required — Contact email address. Please speak with your integration account manager for details on how customer communication is handled for your integration.
    - `phoneNumber` string, required — Contact phone number in international phone number format, example "+1408XXXXXXX".
  - `occupations` object[]
    - `code` string — Occupation field code - this field accepts any job or occupation that the customer does, as the only occupation format currently accepted is `"FREE_FORM"`.
    - `format` string — Occupation field format. As of now, it only accepts the value `"FREE_FORM"`.

## Response `200`

Created personal profile.

- object
  - `id` integer — Unique profile ID.
  - `type` 'PERSONAL' — Profile type.
  - `details` object — Profile details.
    - `firstName` string — First name (including middle names).
    - `lastName` string — Last name.
    - `preferredName` string — Preferred first name.
    - `firstNameInKana` string, nullable — First name in Katakana.
    - `lastNameInKana` string, nullable — Last name in Katakana.
    - `address` object
      - `addressFirstLine` string
      - `city` string
      - `countryIso3Code` string
      - `postCode` string
      - `stateCode` string
    - `nationality` string — 3 letter country code (lower case).
    - `dateOfBirth` string — Date of birth.
    - `externalCustomerId` string — External reference identifier in your system.
    - `contactDetails` object
      - `email` string
      - `phoneNumber` string
    - `occupations` object[]
      - `code` string
      - `format` string
    - `localizedInformation` object[] — Localized information for the profile.

## Other responses

- `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)