# Creates a customer

Creates a Customer object.

Endpoint: POST /customers
Version: v1
Security: apiKey

## Request fields (application/json):

  - `email` (string,null)
    Customer's email address
    Example: "customer@paypro.nl"

  - `first_name` (string,null)
    Customer's first name
    Example: "firstname"

  - `last_name` (string,null)
    Customer's last name
    Example: "name"

  - `address` (string,null)
    Customer's address
    Example: "address 2"

  - `postal` (string,null)
    Customer's postal code or ZIP
    Example: "1234AA"

  - `city` (string,null)
    Customer's city
    Example: "city"

  - `country` (string,null)
    Customer's country in [ISO-3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format, example: 'NL'
    Example: "NL"

  - `vat_number` (string,null)
    Customer's company vat number
    Example: "vatnumber"

  - `company_name` (string,null)
    Customer's company name
    Example: "PayPro"

  - `phone_number` (string,null)
    Customer's phone number
    Example: "012345679"

## Response 201 fields (application/json):

  - `id` (string, required)
    Example: "CU7JRN6W6K3DA9"

  - `type` (string, required)
    Enum: "customer"

  - `email` (string,null, required)
    Example: "customer@paypro.nl"

  - `first_name` (string,null, required)
    Example: "firstname"

  - `last_name` (string,null, required)
    Example: "name"

  - `address` (string,null, required)
    Example: "address 2"

  - `postal` (string,null, required)
    Example: "1234AA"

  - `city` (string,null, required)
    Example: "city"

  - `country` (string,null, required)
    Example: "NL"

  - `vat_number` (string,null, required)
    Example: "vatnumber"

  - `company_name` (string,null, required)
    Example: "PayPro"

  - `phone_number` (string,null, required)
    Example: "012345679"

  - `created_at` (string, required)
    Example: "2022-12-31T23:00:00Z"

  - `_links` (object, required)
    Example: {"self":"https://api.paypro.nl/customers/CU7JRN6W6K3DA9"}

  - `_links.self` (string, required)
    Example: "https://api.paypro.nl/customers/CU7JRN6W6K3DA9"