# Creates a new customer inside the institution.

Endpoint: POST /api/external/v1/customers
Version: v1

## Request fields (application/json):

  - `salutation` (string,null)
    Salutation such as "Herr", "Frau", "Mr.", "Ms.", etc.

  - `title` (string,null)
    Title such as "Dr.", "Prof.", etc.

  - `firstname` (string, required)
    First name of the investor. When sending values with accents (e.g. É, ç, ñ), send the values in UTF-8 charset.

  - `lastname` (string, required)
    Last name of the investor. When sending values with accents (e.g. É, ç, ñ), send the values in UTF-8 charset.

  - `birthDate` (string,null)
    Date of birth not required at customer creation, but necessary for the KYC process.

  - `phoneNumber` (string,null)
    Phone number of the investor.

  - `type` (string, required)
    Enum: "Unknown", "Person", "LegalEntity"

  - `street` (string, required)
    The street name where the investor resides. When sending values with accents (e.g. É, ç, ñ), send the values in UTF-8 charset.

  - `streetNo` (string, required)
    The street number where the investor resides.

  - `postalCode` (string, required)
    The postal code where the investor resides.

  - `town` (string, required)
    The town in which the investor resides. When sending values with accents (e.g. É, ç, ñ), send the values in UTF-8 charset.

  - `countryIso` (string, required)
    The country ISO code in which the investor resides. Use ISO 3166-1 alpha-2 country codes.

  - `company` (object)
    Only required when the account type is LegalEntity.

  - `company.name` (string, required)

  - `company.registerNumber` (string, required)

  - `company.fullAddress` (string, required)

  - `company.email` (string, required)

  - `nationalityIso` (string,null)
    The nationality ISO of the investor. Use ISO 3166-1 alpha-2 country codes.

  - `gender` (string)
    Enum: "NotSet", "Male", "Female", "Other"

  - `monerium` (object)

  - `monerium.profileDocument` (object)

  - `monerium.profileDocument.number` (string, required)

  - `monerium.profileDocument.kind` (string, required)
    The type of ID document. Passports, National ID cards, and driving licenses are supported.
    Enum: "passport", "drivingLicense", "nationalIdentityCard"

  - `monerium.corporate` (object)

  - `monerium.corporate.registrationNumber` (string, required)

  - `monerium.corporate.representatives` (array, required)

  - `monerium.corporate.representatives.firstname` (string, required)

  - `monerium.corporate.representatives.lastname` (string, required)

  - `monerium.corporate.representatives.country` (string, required)

  - `monerium.corporate.representatives.nationality` (string, required)

  - `monerium.corporate.representatives.birthDay` (string, required)

  - `monerium.corporate.representatives.address` (string, required)

  - `monerium.corporate.representatives.postalCode` (string, required)

  - `monerium.corporate.representatives.city` (string, required)

  - `monerium.corporate.representatives.countryState` (string,null)

  - `monerium.corporate.representatives.idDocument` (object, required)

  - `monerium.corporate.finalBeneficiaries` (array,null)

  - `monerium.corporate.finalBeneficiaries.ownershipPercentage` (string,null)

  - `monerium.corporate.directors` (array,null)

  - `tanganyLegalPerson` (object)

  - `tanganyLegalPerson.id` (string,null)
    Not required in case of creating new Tangany legal person

  - `tanganyLegalPerson.name` (string, required)
    The name of the company. You can re-use the value from company.name.

  - `tanganyLegalPerson.legalForm` (string, required)
    Legal form of company. E.g. "AG", "GmbH".

  - `tanganyLegalPerson.commercialRegister` (string,null)
    You may leave it blank. Legally speaking, only the register number is required.

  - `tanganyLegalPerson.leiCode` (string,null)
    LEI code of the company.

  - `tanganyLegalPerson.taxId` (string,null)
    Tax ID of the company.

  - `tanganyLegalPerson.vatId` (string,null)
    Vat ID of the company.

  - `tanganyLegalPerson.isinCode` (string,null)
    ISIN code of the company.

  - `tanganyLegalPerson.legalJurisdiction` (string,null)
    ISO country code (e.g. "DE") where the legal entity is registered. Not mandatory, as this data is captured within the legalAddress object.

  - `tanganyLegalPerson.legalAddress` (object, required)

  - `tanganyLegalPerson.legalAddress.country` (string, required)
    ISO country code (e.g. "DE") where the company is registered.

  - `tanganyLegalPerson.legalAddress.city` (string, required)
    City where company is registered.

  - `tanganyLegalPerson.legalAddress.postcode` (string, required)
    Post code where company is registered.

  - `tanganyLegalPerson.legalAddress.streetName` (string, required)
    Street name where company is registered.

  - `tanganyLegalPerson.legalAddress.streetNumber` (string, required)
    Street number where company is registered.

  - `tanganyLegalPerson.postalAddress` (object)

  - `tanganyLegalPerson.kyc` (object)

  - `tanganyLegalPerson.kyc.businessDescription` (string, required)
    You can always send the following value: "Investor".

  - `tanganyLegalPerson.kyc.isCreAvailable` (boolean, required)
    You can always set this field to false.

  - `tanganyLegalPerson.related` (array, required)

  - `tanganyLegalPerson.related.entityId` (string,null)
    The legal requirement is to create one per beneficial owner of the company (even if they do not have to go through the KYC process).

  - `tanganyLegalPerson.related.position` (string,null)
    Position of the beneficial owner in the company.

  - `tanganyLegalPerson.related.isFictitiousBeneficialOwner` (boolean, required)
    Indicates if this is a fictitious beneficial owner.

  - `tanganyLegalPerson.related.isUltimateBeneficialOwner` (boolean, required)
    Indicates if this is the ultimate beneficial owner.

  - `tanganyLegalPerson.related.sharePercentage` (string,null)
    Share percentage of ownership.

  - `tanganyLegalPerson.related.naturalPerson` (object)

  - `tanganyLegalPerson.related.naturalPerson.id` (string, required)
    Customer ID received after creating a customer in NYALA's system.

  - `tanganyLegalPerson.related.naturalPerson.firstName` (string, required)
    First name of the investor. When sending values with accents (e.g. É, ç, ñ), send the values in UTF-8 charset.

  - `tanganyLegalPerson.related.naturalPerson.lastName` (string, required)
    Last name of the investor. When sending values with accents (e.g. É, ç, ñ), send the values in UTF-8 charset.

  - `tanganyLegalPerson.related.naturalPerson.birthDate` (string, required)
    Date of birth is a regulatory requirement for the KYC process.

  - `tanganyLegalPerson.related.naturalPerson.birthPlace` (string, required)
    Place of birth denoted in the used identification document of the investor.

  - `tanganyLegalPerson.related.naturalPerson.title` (string,null)
    Titles such as "Dr.", "Prof.", etc.

  - `tanganyLegalPerson.related.naturalPerson.birthCountry` (string,null)
    Country of birth using two-letter country code (ISO 3166-1 alpha-2)

  - `tanganyLegalPerson.related.naturalPerson.birthName` (string,null)

  - `tanganyLegalPerson.related.naturalPerson.nationality` (string,null)
    ISO country codes (e.g. "DE").

  - `tanganyLegalPerson.related.naturalPerson.email` (string,null)
    The email which the investor used to register. You can re-use the same input as from customer creation.

  - `tanganyLegalPerson.related.naturalPerson.selfDeclaredAsPep` (boolean)
    Indicates whether the investor has self-declared as a Politically Exposed Person (PEP).

  - `tanganyLegalPerson.related.legalPerson` (object)

  - `custodyProvider` (string)
    Enum: "HADC", "Tangany", "TanganyExternal", "Iris"

  - `email` (string, required)
    The email which the investor used to register. This must be unique and cannot be reused by other investors.

  - `hadcCustomerId` (string,null)

  - `id` (string,null)
    If not provided, it will be auto-generated.

## Response 200 fields (application/json):

  - `errorMessageCodes` (array,null)

  - `errors` (array,null)

  - `errors.code` (string,null)

  - `errors.message` (string,null)

  - `errors.field` (string,null)

  - `data` (string)