---
title: "Create a New Individual Account"
method: POST
path: "/v2/accounts/individual"
tags: ["Accounts | Create & KYC"]
---

# Create a New Individual Account

`POST /v2/accounts/individual`

Lets you to create a individual payment account  
1. Your Client enter their data on your platform, for example on their profile space.  
2. Your server calls our Accounts API.  
3. Lemonway creates the payment account in your environment.  
4. Your system reads the method response and informs the user.   

We apply our validation rules for different parameters.   

**Check Injection:**      
* String parameters (email, name and so on) must not contain odd characters.  

**Names (first and last name)**    

* Not made-up names: "name", "nom", "prénom", "prenom", "lastname", "last_name", "last name", "firstname", "first_name", "first name", "name", "test", "unknow"      
* Names must have at least 2 characters with at least 1 vowel     
* The first name must not be the same as the last name     
* Using the same the same character 3 times in a row will cause an error    
* We might apply other validation rules, for example: in the case VIP (politician)

## Headers

- `Authorization` string, required
- `PSU-Accept-Language` string
- `PSU-IP-Address` string, required
- `PSU-User-Agent` string

## Request body

- RegisterIndividualAccountInput
  - `accountId` string, required — Payment account ID that you use to identify the customer.Choose your unique number.<br /><b>Note:</b> If you plan to credit payments accounts by fund transfer, please use short alphanumeric payment account identifiers (max 20 char.). Your customers will have to write their payment account identifier in the transfer label/comment, a label of more that 20 characters could be cut when passing the the banking system.
  - `email` string — Unique Email
  - `title` string — Client title
  - `firstName` string, required — Client first name
  - `lastName` string, required — Client last name
  - `adresse` Address
    - `street` string — Client number and street
    - `postCode` string — Client Postcode/ZIP
    - `city` string — Client city
    - `country` string — Client country using ISO 3166-1 alpha-3
  - `birth` Birth
    - `date` string — Client Date of Birth
    - `city` string — Client City of Birth
    - `Country` string — Client Country of Birth, using ISO 3166-1 alpha-3. Three-letter country code, for example: FRA (France), GBR (United Kingdom of Great Britain and Northern Ireland)
  - `nationality` string — Client nationality, using ISO 3166-1 alpha-3 format Please separate multiple nationalities with a comma
  - `phoneNumber` string — Phone number with MSISDN format: international number with country code without "00" neither "+".
  - `mobileNumber` string — Mobile phone number with MSISDN format: international number with country code without "00" neither "+". This will be used by default when eletronically signing documents.
  - `isDebtor` boolean — For crowdfunding/loan platforms, indicates if the wallet is created for a debtor.
  - `payerOrBeneficiary` integer — Indicates if the payment account is created for a Payer or a Beneficiary. 1: Payer (default) 2: Beneficiary
  - `isOneTimeCustomerAccount` boolean — Indicates if the payment account is for a one-time customer. If yes, the payment account will be created with status 14, allowing only one payment. The maximum amount will be defined with Lemonway.
  - `isTechnicalAccount` boolean — **Note:** This option is available depending on your contract True, in case this option is enabled in your contract. Otherwise it will be considered a Client Wallet.
  - `isUltimateBeneficialOwner` boolean

## Response `200`

OK

- RegisterIndividualAccountOutput
  - `account` IndividualAccount
    - `id` string — Payment Account ID
    - `internalId` integer — Internal ID given by Lemonway (ID displayed on the Lemonway Dashboard)
    - `limits` Limits
      - `totalMoneyInAllowed` integer — Total Money-In number allowed for this account
      - `amountMoneyInAllowed` number, double — Total Money-In amount allowed for this wallet
  - `error` Error
    - `code` integer
    - `message` string
    - `psp` PSP
      - `message` string — Get the Error Message from PSP

## Other responses

- `401` — Unauthorized
- `500` — InternalServerError

---

[API](https://skmtc.net/lemonway/apis/account-onboarding-management-api.md) · [All operations](https://skmtc.net/lemonway/apis/account-onboarding-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lemonway/account-onboarding-management-api/revisions/73309fe68e2d/schema)