---
title: "Creates a new client."
method: POST
path: "/customers"
tags: ["Clients"]
---

# Creates a new client.

`POST /customers`

Creates a new client. All available fields are presented in PUT request.<p>
  Required fields:
  <ul>
    <li>name</li>
    <li>fullName</li>
    <li>contact -> emails -> primary</li>
  </ul>
</p>

## Request body

- CustomerDTO
  - `id` integer
  - `idNumber` string
  - `name` string
  - `fullName` string
  - `notes` string
  - `peppolIdScheme` string
  - `peppolIdCode` string
  - `peppolId` string
  - `billingAddress` AddressDTO
    - `sameAsBillingAddress` boolean — should billing address be used instead of this one
    - `addressLine1` string — first line of address
    - `addressLine2` string — second line of address
    - `city` string — city
    - `postalCode` string — postal code
    - `provinceId` integer — province
    - `countryId` integer — country
  - `correspondenceAddress` AddressDTO
    - `sameAsBillingAddress` boolean — should billing address be used instead of this one
    - `addressLine1` string — first line of address
    - `addressLine2` string — second line of address
    - `city` string — city
    - `postalCode` string — postal code
    - `provinceId` integer — province
    - `countryId` integer — country
  - `contact` ContactDTO
    - `phones` string[] — phones' numbers
    - `sms` string — mobile phone for which SMS notifications will be sent (if configured)
    - `fax` string — fax number
    - `emails` CustomerContactEmailsDTO — emails
      - `primary` string, required — primary e-mail
      - `cc` string[] — e-mails which will be included in the CC list
      - `additional` string[] — additional e-mails addresses
    - `websites` string[] — websites
  - `branchId` integer
  - `leadSourceId` integer
  - `customFields` CustomFieldDTO[]
    - `type` 'TEXT' | 'DATE' | 'DATE_AND_TIME' | 'NUMBER' | 'CHECKBOX' | 'SELECTION' | 'MULTI_SELECTION'
    - `name` string
    - `key` string
    - `value` object
  - `status` 'ACTIVE' | 'INACTIVE' | 'POTENTIAL'
  - `responsiblePersons` CustomerResponsiblePersonsDTO
    - `projectManagerId` integer, required — project manager
    - `salesPersonId` integer, required — sales person
    - `accountManagerId` integer — account manager
    - `projectCoordinatorId` integer — project coordinator
  - `accounting` CustomerAccountingDTO
    - `taxNumbers` CustomerTaxNoDTO[]
      - `number` string — tax number
      - `type` string — type (ie. NIP, VAT Reg No, P.IVA) or empty value if unknown
  - `contractNumber` string
  - `salesNotes` string
  - `accountOnCustomerServer` string
  - `clientFirstProjectDate` string, date-time
  - `clientFirstQuoteDate` string, date-time
  - `clientLastProjectDate` string, date-time
  - `clientLastQuoteDate` string, date-time
  - `clientNumberOfProjects` integer
  - `clientNumberOfQuotes` integer
  - `persons` CustomerPersonDTO[]
    - `id` integer
    - `name` string
    - `lastName` string
    - `contact` PersonContactDTO
      - `phones` string[] — phones' numbers
      - `sms` string — mobile phone for which SMS notifications will be sent (if configured)
      - `fax` string — fax number
      - `emails` PersonContactEmailsDTO — emails
        - `primary` string, required — primary e-mail
        - `additional` string[] — additional e-mails addresses
    - `positionId` integer
    - `gender` 'FEMALE' | 'MALE'
    - `active` boolean
    - `motherTonguesIds` integer[]
    - `customFields` CustomFieldDTO[]
      - `type` 'TEXT' | 'DATE' | 'DATE_AND_TIME' | 'NUMBER' | 'CHECKBOX' | 'SELECTION' | 'MULTI_SELECTION'
      - `name` string
      - `key` string
      - `value` object
    - `customerId` integer
    - `firstProjectDate` string, date-time
    - `firstQuoteDate` string, date-time
    - `lastProjectDate` string, date-time
    - `lastQuoteDate` string, date-time
    - `numberOfProjects` integer
    - `numberOfQuotes` integer
  - `categoriesIds` integer[]
  - `industriesIds` integer[]
  - `limitAccessToPeopleResponsible` boolean

## Response `default`

Success

---

[API](https://skmtc.dev/xtrf/apis/xtrf-home-portal-api.md) · [All operations](https://skmtc.dev/xtrf/apis/xtrf-home-portal-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/xtrf/xtrf-home-portal-api/revisions/0c24935a3319/schema)