# Creation of customer

Endpoint: POST /api/customers
Version: 1.0.0
Security: shoptetAccessToken, shoptetPrivateApiToken

## Query parameters:

  - `suppressMandatoryFieldsCheck` (boolean)
    suppress checking if new customer has filled all mandatory fields
from eshop settings .
Suppressing this check can cause worse customer experience in order
process for customers without all mandatory fields! However this can
be useful for migration customers from older system without all
necessary fields.

  - `sendRegistrationEmail` (boolean)
    If set to true, registration emails are sent to the customer. The
type of email depends on the  settings. If the group
requires verification, the customer receives an email indicating
that the registration is pending administrator approval (typically
for the  group). Otherwise, the customer receives a
standard registration confirmation email.

If the customer group has email notifications enabled for the 
administrator, a copy of the email is also sent to them (again,
typically for the  group).

  - `language` (string)
    Specifies the language in which the email should be sent to the
customer, provided that  and the
"Foreign Languages" module is enabled on the current e-shop.
    Example: "cs"

## Header parameters:

  - `Content-Type` (string, required)

## Request fields (application/json):

  - `data` (object, required)

  - `data.remark` (string,null)
    remark for the customer (can be )

  - `data.priceRatio` (string)
    additional discount - 4 decimal places accuracy, (from  to ), 0.7800 = discount 22%; 1.0000 = no discount

  - `data.birthDate` (string,null)
    date of birth. In YYYY-MM-DD format.  (can be )

  - `data.disabledOrders` (boolean)
    Ordering disabled? If so, newly created orders will be cancelled automatically.

  - `data.customerGroupCode` (string)
    customer group code, group must exists if set.

  - `data.pricelistId` (integer)
    Price list identifier

  - `data.billingAddress` (object)
    billing address

  - `data.billingAddress.company` (string,null)
    company (can be )

  - `data.billingAddress.fullName` (string,null)
    full name (can be )

  - `data.billingAddress.street` (string,null)
    street (can be )

  - `data.billingAddress.houseNumber` (string,null)
    house number (can be )

  - `data.billingAddress.city` (string,null)
    city/town (can be )

  - `data.billingAddress.district` (string,null)
    region (can be )

  - `data.billingAddress.additional` (string,null)
    additional address information (can be )

  - `data.billingAddress.zip` (string,null)
    ZIP or postal code (can be )

  - `data.billingAddress.countryCode` (string)
    country (can be )

  - `data.billingAddress.regionName` (string,null)
    region name (can be )

  - `data.billingAddress.companyId` (string,null)
    Company registration number of the customer, if purchasing as a company. Optional.

  - `data.billingAddress.vatId` (string,null)
    VAT identification number of the customer, if purchasing as a company. Optional.

  - `data.billingAddress.taxId` (string,null)
    TAX identification number of the customer, if purchasing on the company. For Czech address, taxId must be the same as vatId, or left empty. Optional.

  - `data.account` (object, required)

  - `data.account.email` (string, required)
    email address

  - `data.account.phone` (string,null)
    phone number (can be )

  - `data.account.authorized` (boolean)
    Is the account authorized? Default: true

  - `data.account.emailVerified` (boolean)
    Is the email verified by eshop owner? Needed for pairing orders created in past. Default: false

## Response 201 fields (application/json):

  - `data` (object, required)

  - `data.customer` (object, required)

  - `data.customer.guid` (string, required)
    Customer GUID

  - `data.customer.billingAddress` (object, required)
    invoicing address

  - `data.customer.billingAddress.company` (string,null, required)
    name of purchaser''s company (or )

  - `data.customer.billingAddress.fullName` (string,null, required)
    name of purchaser (or )

  - `data.customer.billingAddress.street` (string,null, required)
    street of purchaser (or )

  - `data.customer.billingAddress.houseNumber` (string,null, required)
    street number (or )

  - `data.customer.billingAddress.city` (string,null, required)
    city/town (village) (or )

  - `data.customer.billingAddress.district` (string,null, required)
    county (or )

  - `data.customer.billingAddress.additional` (string,null, required)
    additional address information (or )

  - `data.customer.billingAddress.zip` (string,null, required)
    ZIP or postal code (or )

  - `data.customer.billingAddress.countryCode` (string,null, required)
    tree-character ISO country code (ISO 4217)

  - `data.customer.billingAddress.regionName` (string,null, required)
    region name (or )

  - `data.customer.billingAddress.regionShortcut` (string,null, required)
    region abbreviation (or )

  - `data.customer.billingAddress.companyId` (string,null, required)
    Company registration number. (can be )

  - `data.customer.billingAddress.vatId` (string,null, required)
    VAT identification number. (can be )

  - `data.customer.billingAddress.vatIdValidationStatus` (any)
    Info, whether VAT ID has been verified, enum [, , ]
    Enum: "unverified", "verified", "waiting", null

  - `data.customer.billingAddress.taxId` (string,null, required)
    TAX identification number. For Czech address, taxId is same as vatId. (can be )

  - `data.customer.deliveryAddress` (array, required)
    delivery addresses

  - `data.customer.deliveryAddress.guid` (string, required)
    customer delivery address identification

  - `data.customer.deliveryAddress.company` (string,null, required)
    company (can be )

  - `data.customer.deliveryAddress.fullName` (string,null, required)
    full name (can be )

  - `data.customer.deliveryAddress.street` (string,null, required)
    street (can be )

  - `data.customer.deliveryAddress.houseNumber` (string,null, required)
    house number (can be )

  - `data.customer.deliveryAddress.city` (string,null, required)
    city/town (can be )

  - `data.customer.deliveryAddress.district` (string,null, required)
    region (can be )

  - `data.customer.deliveryAddress.additional` (string,null, required)
    additional info (can be )

  - `data.customer.deliveryAddress.zip` (string,null, required)
    ZIP/postal code (can be )

  - `data.customer.deliveryAddress.countryCode` (string,null, required)
    country (can be )

  - `data.customer.deliveryAddress.regionName` (string,null, required)
    region name (can be )

  - `data.customer.deliveryAddress.regionShortcut` (string,null, required)
    region abbreviation (can be )

  - `data.customer.deliveryAddress.isDefault` (boolean)

  - `data.customer.creationTime` (string,null, required)
    registration date

  - `data.customer.changeTime` (string,null, required)
    date and time of last change

  - `data.customer.customerGroup` (object,null, required)
    group of customers

  - `data.customer.customerGroup.id` (number, required)
    customer group ID

  - `data.customer.customerGroup.name` (string, required)
    customer group name

  - `data.customer.priceList` (any, required)
    inclusion into the price list

  - `data.customer.remark` (string,null, required)
    remark for the customer (can be )

  - `data.customer.priceRatio` (string, required)
    additional discount - 0.7800 = discount 22%; 1.0000 = no discount

  - `data.customer.birthDate` (string,null, required)
    date of birth. In YYYY-MM-DD format.  (can be )

  - `data.customer.accounts` (array, required)
    customer login accounts

  - `data.customer.accounts.guid` (string, required)
    customer account identifier

  - `data.customer.accounts.email` (string, required)
    email address

  - `data.customer.accounts.phone` (string,null, required)
    phone (can be )

  - `data.customer.accounts.mainAccount` (boolean, required)
    Is this the main account?

  - `data.customer.accounts.authorized` (boolean, required)
    Is the account authorized? Default: true

  - `data.customer.accounts.emailVerified` (boolean, required)
    Is the email verified by eshop owner? Needed for pairing orders created in past. Default: false

  - `data.customer.disabledOrders` (boolean, required)
    Ordering disabled? If so, newly created orders will be cancelled automatically. Dependent on the addition of . If e-shop does not have an option active, the answer will be .

  - `data.customer.remarks` (array, required)
    customer notes and ratings, dependent on addon . If e-shop does not have an option active, the answer will be blank.

  - `data.customer.remarks.id` (integer, required)
    uniq identification number

  - `data.customer.remarks.remark` (string, required)
    note

  - `data.customer.remarks.rating` (string, required)
    type of rating

  - `data.customer.adminUrl` (string, required)
    link to the customer details in administration

  - `errors` (array,null, required)

  - `errors.errorCode` (string, required)
    Short text error identification

  - `errors.message` (string, required)
    Descriptive error message

  - `errors.instance` (string, required)
    Identification of the entity referenced