---
title: "Creates a customer"
method: POST
path: "/v2/customer/create"
tags: ["CustomerDomainCommand"]
---

# Creates a customer

`POST /v2/customer/create`

## Headers

- `x-tenant-id` string, uuid, required
- `x-runas` string
- `x-companyid` string

## Request body

- JTLWawiCustomersPublicApiDataTransferObjectsV2CustomerDomainCreateCustomerCommandRequest — Creates a customer - Request
  - `companyId` string, uuid — Represents a key for identifying a firm within the application.
  - `customerGroupId` string, uuid
  - `customerCategoryId` string, uuid
  - `paymentMethodId` string, uuid
  - `accountsReceivableNumber` integer — The accounts receivable number of the customer.
  - `birthday` string, date-time — The customer's date of birth.
  - `commercialRegisterNumber` string — The customer's commercial register number.
  - `customerNumber` string — Number of the customer. If no number is given when posting a customer, the number will be generated automatically.
  - `ebayName` string — The customers ebay name.
  - `homepage` string — The customers homepage URL.
  - `initialContact` string — The source of initial contact. This could be for example a specific sales channel, a convention or a marketing campaign.
  - `isCashRegisterBased` boolean — States if a customer is from a cash-register or point of sale and if their data should be synchronized with JTL-POS, for example.
  - `isLocked` boolean — The customer's locked status.
  - `languageIso` string — The customer's preferred language in ISO format (e.g. "de", "en").
  - `taxIdentificationNumber` string — The customer's tax identification number.
  - `billingAddress` JTLWawiCustomersPublicApiDataTransferObjectsV2CustomerDomainCreateCreateCustomerAddress — Model Class: CreateCreateCustomerAddress
    - `street` string — Name of the street (including number).
    - `additionalAddressLine` string — Additional address information.
    - `city` string — City name of the customer.
    - `postalCode` string — Postal code of the customer.
    - `state` string — Name of the state.
    - `countryIso` string — ISO code of the country (2 letters).
    - `emailAddress` string — The customers email address.
    - `phoneNumber` string — The customers phone number.
    - `mobilePhoneNumber` string — The customers mobile phone number.
    - `faxNumber` string — The customers fax number.
    - `vatId` string — The customers VAT ID.
    - `salutation` string — The customers salutation (e.g. Mr., Mrs., etc.)
    - `title` string — The customers title (e.g. Dr., Prof., etc.)
    - `firstName` string — The customers first name
    - `lastName` string — The customers last name
    - `companyName` string — The customers company name
    - `additionalCompanyLine` string — The customers company additional line
  - `shipmentAddress` JTLWawiCustomersPublicApiDataTransferObjectsV2CustomerDomainCreateCreateCustomerAddress — Model Class: CreateCreateCustomerAddress
    - `street` string — Name of the street (including number).
    - `additionalAddressLine` string — Additional address information.
    - `city` string — City name of the customer.
    - `postalCode` string — Postal code of the customer.
    - `state` string — Name of the state.
    - `countryIso` string — ISO code of the country (2 letters).
    - `emailAddress` string — The customers email address.
    - `phoneNumber` string — The customers phone number.
    - `mobilePhoneNumber` string — The customers mobile phone number.
    - `faxNumber` string — The customers fax number.
    - `vatId` string — The customers VAT ID.
    - `salutation` string — The customers salutation (e.g. Mr., Mrs., etc.)
    - `title` string — The customers title (e.g. Dr., Prof., etc.)
    - `firstName` string — The customers first name
    - `lastName` string — The customers last name
    - `companyName` string — The customers company name
    - `additionalCompanyLine` string — The customers company additional line
  - `paymentSettings` JTLWawiCustomersPublicApiDataTransferObjectsV2CustomerDomainCreateCreateCustomerPaymentSettings — Model Class: CreateCreateCustomerPaymentSettings
    - `creditLimit` integer — The customers credit limit.
    - `paymentDueDateInDays` integer — Payment target (in days).
    - `discount` number — The customers discount percentage.
    - `isDunningBlocked` boolean — Whether the customer is blocked for dunning notices.

## Response `201`

Customer created successfully

---

[API](https://skmtc.net/jtl-software/apis/scx-authentication-api.md) · [All operations](https://skmtc.net/jtl-software/apis/scx-authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jtl-software/scx-authentication-api/revisions/f979b1ea6951/schema)