---
title: "Přidání zákazníka"
description: "Přidá nového zákazníka."
url: /cs/api-reference/legacy/zakaznici/pridani-zakaznika/
---

<Endpoint method="POST" path="/customer" />

### Tělo požadavku
<Param name="externalId" type="string">
Nepovinné. Unikátní identifikátor záznamu
</Param>

<Param name="name" type="string" required>
Jméno zákazníka
</Param>

<Param name="categoryId" type="string/string(GUID)">
ID nebo Slug kategorie zákazníka ([CustomerCategory](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#customercategory))\
Pokud není vyplněno, použije se první hodnota z číselníku CustomerCategory
</Param>

<Param name="typeId" type="string/string(GUID)">
ID nebo Slug typu zákazníka ([CustomerType](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#customertype))\
Pokud není vyplněno, použije se první hodnota z číselníku CustomerType
</Param>

<Param name="kind" type="CustomerKind">
Druh zákazníka ([CustomerKind](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#customerkind))\
Výchozí hodnota: `Company`

:::note
Validační pravidla se liší na základě hodnoty `kind`

`Company`:

* IČ je povinný údaj.

`Household`:

*  IČ, DIČ a Kontaktní adresa nemůžou být vyplněné.
:::
</Param>

<Param name="contactPeople" type="ContactPersonToAdd[]" required>
Kontaktní osoby zákazníka.\
Musí obsahovat alespoň jednu kontaktní osobu. Obsah je shodný s endpointem [Přidání kontaktní osoby](/cs/api-reference/legacy/zakaznici/kontaktni-osoba/pridani-kontaktni-osoby/#tělo-požadavku)
</Param>

<Param name="addresses" type="CustomerAddressToAdd[]" required>
Adresy zákazníka\
Musí obsahovat alespoň jednu adresu. Obsah je shodný s endpointem [Přidání adresy](/cs/api-reference/legacy/zakaznici/adresa-zakaznika/pridani-adresy/#tělo-požadavku)
</Param>

<Param name="serviceObjects" type="ServiceObjectToAdd[]">
Zařízení zákazníka\
Obsah je shodný s endpointem [Přidání zařízení](/cs/api-reference/legacy/zakaznici/zarizeni/pridani-zarizeni/#tělo-požadavku)
</Param>

<Param name="primaryContactPersonId" type="string">
Externí ID primární kontaktní osoby\
Pokud není vyplněno, použije se první kontaktní osoba z  `contactPeople`
</Param>

<Param name="invoiceAddressId" type="string">
Externí ID fakturační adresy\
Pokud není vyplněno, použije se první adresa z `addresses`
</Param>

<Param name="contactAddressId" type="string">
Externí ID kontaktní adresy zákazníka (pouze pro firmy viz [CustomerKind](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#customerkind))\
Pokud není vyplněno, je kontaktní adresa shodná s adresou fakturační
</Param>

<Param name="ownerId" type="string">
ID nebo Externí ID vlastníka. Pokud není manuálně nastaveno, je vlastníkem standardně uživatel, který zákazníka založil. V případě založení přes API je vlastníkem zákazníka uživatel s rolí Administrátor.
</Param>

<Param name="identificationNumber" type="string" required requiredNote="povinné pro firmy">
IČ (pouze pro firmy viz [CustomerKind](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#customerkind))
</Param>

<Param name="taxNumber" type="string">
DIČ (pouze pro firmy viz [CustomerKind](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#customerkind))
</Param>

<Param name="website" type="string">
Webová stránka
</Param>

<Param name="description" type="string">
Poznámky
</Param>

<Param name="customData" type="string(JSON)">
Dodatečná data k zákazníkovi ve formátu JSON. Musí odpovídat šabloně.
</Param>

### Odpověď
<Status code="201 Created">
Zákazník byl úspěšně přidán
</Status>

<Status code="400, 401, atd.">
Více informací na stránce [standardní chybové stavy](/cs/api-reference/legacy/obecne-informace/standardni-chybove-stavy/).
</Status>

### Příklad

```bash
curl -L -X POST 'https://app.mwork365.com/main/publicapi/customer' \
-H 'Authorization: Bearer eyJhb...WlUw' \
-H 'Content-Type: application/json' \
--data-raw '{
    "externalId": "mwork",
    "kind": "Company",
    "name": "mWork365 s.r.o.",
    "identificationNumber": "07722923"
    "categoryId": "zakladni",
    "typeId": "normal",
    "website": "https://www.mwork365.com",
    "contactPeople:" [
        {
            "externalId": "mwork_p1",
            "firstName": "Jan",
            "lastName": "Novák",
            "position": "Vedoucí provozu",
            "phone": {
                "prefix": "+420",
                "phone": "999777888"
            },
            "sendNotifications": true
        },
        {
            "externalId": "mwork_p2",
            "firstName": "Tomáš",
            "lastName": "Dvořák",
            "position": "Jednatel",
            "email": "tomas.dvorak@mwork365.com"
            "sendNotifications": true,
            "sendReports": true
        }
    ],
    "addresses": [
        {
            "street": "Novoveská 1262/95",
            "city": "Ostrava",
            "postalCode": "709 00",
            "country": "Česká Republika",
            "coordinates": {
                "latitude": 49.83284,
                "longitude": 18.24369
            }
        }
    ],
    "primaryContactPersonId": "mwork_p2"
}'
```