> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vytvořit profil

> Vytvořit nový profil pacienta a přiřadit ho do skupiny profilů

Vytvoř nový profil pacienta a přiřaď ho do skupiny profilů. Profil obsahuje demografické údaje používané u termínů a laboratorních objednávek.

Vyžaduje oprávnění `create_user`.

Odešli volitelnou hlavičku `Idempotency-Key`, aby šlo toto vytvoření bezpečně zopakovat — opakované použití stejného klíče vrátí původní odpověď místo vytvoření dalšího záznamu. Viz [Idempotence](https://docs.anivahealth.com/cs/concepts/idempotency.md).

## Požadavek

### Parametry těla

**first\_name** `string` *required*

Křestní jméno pacienta. Musí obsahovat znaky latinky, délka 1 až 100 znaků.

**last\_name** `string` *required*

Příjmení pacienta. Musí obsahovat znaky latinky, délka 1 až 100 znaků. Laboratoře odmítají
objednávky pro pacienta bez příjmení, takže bez něj nelze profil vytvořit.

Tři hodnoty jsou vyhrazeny pro předvyplnění testovacích dat — viz [Testovací data pro sandbox](#testovaci-data-pro-sandbox).

**sex** `integer` *required*

Biologické pohlaví podle ISO/IEC 5218. Použij `1` pro muže, `2` pro ženu. Laboratoř ho
potřebuje pro referenční rozmezí, takže `0` (neznámé) vrátí `400`. Povinné, pokud tvá skupina
profilů neumožňuje pacientovi zadat ho na stránce pro aktivaci sady. V takovém případě pole
vynech. Viz
[Nechat pacienta zadat datum narození a pohlaví](https://docs.anivahealth.com/cs/concepts/profiles.md#nechat-pacienta-zadat-datum-narozeni-a-pohlavi).

**date\_of\_birth** `string` *required*

Datum narození ve formátu `YYYY-MM-DD`. Musí být v minulosti a ne před rokem 1900. Výsledný
věk musí být mezi 16 a 100 lety. Jiné hodnoty vrátí `400`. Povinné, pokud tvá skupina profilů
neumožňuje pacientovi zadat ho na stránce pro aktivaci sady. V takovém případě pole vynech.

**profile\_group** `string` *required*

Polymorfní odkaz (UUID nebo slug) na skupinu profilů, do které se tento profil přiřadí. UUID je
neměnný identifikátor a přežije přejmenování slugu; slug zůstává podporovaný pro marketingové a
partnerské integrace postavené na čitelných identifikátorech. Preferováno je UUID. Skupina
profilů musí spadat do přístupového kontextu tvého API klíče. Povinné, pokud neposíláš
zastaralé pole `profile_group_slug`.

**profile\_group\_slug** `string` *deprecated*

Zastaralé: použij `profile_group`. Slug skupiny profilů. Pouze malá písmena, číslice, pomlčky a
podtržítka.

**email** `string`

E-mailová adresa profilu. Pokud ji vynecháš, Aniva ji automaticky vygeneruje.

Zadání pole `email` také zajistí, že vytvoření je **bezpečné při opakování**: jedna adresa může
mít vždy jen jeden profil, takže opakovaný požadavek vrátí `409` místo druhého profilu.
Automaticky generované adresy jsou pro každý požadavek jedinečné. Pokud tvá integrace požadavky
opakuje, pošli `email` nebo `Idempotency-Key`.

**phone** `string`

Telefonní číslo ve formátu E.164 (např. `+14155552671`).

**height** `number`

Výška v centimetrech.

**weight** `number`

Hmotnost v kilogramech.

**language** `string` (default: en)

Preferovaný jazyk profilu: `en`, `bg`, `ca`, `cs`, `da`, `de`, `el`, `es`, `et`, `fi`, `fr`, `ga`, `hr`, `hu`, `is`, `it`, `lb`, `lt`, `lv`, `mt`, `nl`, `no`, `pl`, `pt`, `ro`, `ru`, `sk`, `sl`, `sr`, `sv`, `tr` nebo `uk`. Výchozí hodnota je `en`.

**transactional\_emails\_enabled** `boolean`

Zda má tento profil dostávat transakční (systémové) e-maily — potvrzení termínů, oznámení o
připravených výsledcích apod. Přepisuje výchozí nastavení skupiny profilů. Nezávisí na souhlasu
s marketingem. Vynech, pokud chceš použít výchozí nastavení.

**marketing\_emails\_enabled** `boolean`

Zda tento profil souhlasí s marketingovými e-maily (newslettery, produktové novinky). Přepisuje
výchozí nastavení skupiny profilů. Nezávisí na transakčních e-mailech. Vynech, pokud chceš použít
výchozí nastavení skupiny profilů. Pouze pro zápis: v odpovědi profilu se nevrací.

## Testovací data pro sandbox

Každá cesta pro čtení, kterou stojí za to otestovat — [Vypsat termíny](https://docs.anivahealth.com/cs/api/appointments/list-appointments.md),
[Získat výsledky](https://docs.anivahealth.com/cs/api/appointments/get-results.md),
[Stáhnout dokument](https://docs.anivahealth.com/cs/api/documents/download-document.md) — je prázdná, dokud o několik dní později
neproběhne skutečný odběr krve. Psát automatizované integrační testy je pak nepraktické.

Pro vyřešení tohoto problému jsou vyhrazeny tři hodnoty `last_name`. Vytvoř profil s jednou z nich
a Aniva ještě před odesláním odpovědi předvyplní stav popsaný níže, takže ho tvé další volání už
uvidí:

| `last_name` | Co profil dostane |
| - | - |
| `Upcomingtestmann` | Jeden nadcházející termín ve stavu `confirmed` s přiřazeným panelem. Zatím bez výsledků. |
| `Partialtestmann` | Jeden proběhlý termín ve stavu `blood_drawn`. Zhruba **polovina** panelu má výsledky; [Získat výsledky](https://docs.anivahealth.com/cs/api/appointments/get-results.md) vrací `in_progress`. |
| `Fulltestmann` | Jeden proběhlý termín ve stavu `blood_drawn`. **Každý** biomarker v panelu má výsledky, `status: "completed"` a PDF laboratorní zprávy v `documents[]`. |

Porovnání nerozlišuje velikost písmen. Každé další pole — včetně `date_of_birth` a `sex` — se
ukládá a používá běžným způsobem, takže vrácená referenční rozmezí odpovídají skutečnému věku a
pohlaví vytvořeného profilu.

Termín se rezervuje na pobočce **Aniva Test**, ve skutečném rezervovatelném slotu nejméně za pět dní
od teď (nebo před pěti dny u minulých stavů). Jeho vygenerování nezadá laboratorní objednávku ani neobjedná
kurýra.

> [!NOTE]
>
> Testovacím profilům dej adresu, kterou máš pod kontrolou. Připomínky termínů Aniva se řídí podle
> `scheduled_at`, takže nadcházející fixture je odešle, pokud profil není odhlášený přes
> `transactional_emails_enabled: false`.

Panel se vybere náhodně z těch, které tvůj API klíč vidí, takže jeho `panel_id` vždy najdeš
ve svém [Seznamu panelů](https://docs.anivahealth.com/cs/api/panels/list-panels.md). Klinické biomarkery dostanou hodnotu v rámci
referenčního rozmezí biomarkeru; geny dostanou náhodný genotyp z referenčních dat Aniva, z něhož vycházejí odpovídající varianty, klinický význam a rs ID.

> [!NOTE]
>
> Panel a hodnoty se při každém vytvoření generují znovu, takže ověřuj spíš strukturu než konkrétní
> panel nebo přesná čísla.

## Odpověď

Při úspěchu vrátí API `201 Created` s nově vytvořeným profilem.

**id** `string` *required*

Jedinečný identifikátor profilu (UUID).

**handle** `string`

Handle nebo uživatelské jméno profilu. Může být `null`.

**first\_name** `string`

Křestní jméno. Může být `null`.

**last\_name** `string`

Příjmení. Může být `null`.

**email** `string`

E-mailová adresa. Může být `null`.

**phone** `string`

Telefonní číslo ve formátu E.164. Může být `null`.

**sex** `integer`

Biologické pohlaví podle ISO/IEC 5218 (`0` = neznámé, `1` = muž, `2` = žena). Může být `null`.

**date\_of\_birth** `string`

Datum narození ve formátu `YYYY-MM-DD`. Může být `null`.

**height** `number`

Výška v centimetrech. Může být `null`.

**weight** `number`

Hmotnost v kilogramech. Může být `null`.

**language** `string`

Preferovaný jazyk, jeden z 32 kódů výše.

**transactional\_emails\_enabled** `boolean`

Zda tento profil přijímá transakční (automatické) e-maily. `null`, pokud nebylo nikdy nastaveno.

**created\_at** `string`

Časové razítko ISO 8601 vytvoření profilu.

**updated\_at** `string`

Časové razítko ISO 8601 poslední aktualizace. `null` u nově vytvořených profilů.

## Chybové odpovědi

| Stav | Popis |
| - | - |
| `400` | Chyba validace — jedno nebo více polí neprošlo validací. |
| `403` | Zakázáno — tvůj API klíč nemá přístup k této operaci nebo skupina profilů leží mimo tvůj kontext přístupu. |
| `404` | Skupina profilů nebyla nalezena. |
| `409` | Profil pro zadaný `email` už existuje (odpověď obsahuje tuto adresu), nebo existuje pro stejnou osobu (viz níže), nebo byl `Idempotency-Key` znovu použit s jiným tělem požadavku, případně původní požadavek ještě neskončil. |
| `500` | Interní chyba serveru. |

Odpověď `409` vypadá takto — ber ji jako „tento profil už existuje“ a místo opakování vytvoření ho vyhledej
přes [Seznam profilů](https://docs.anivahealth.com/cs/api/profiles/list-profiles.md) (`?email=`):

```json theme={null}
{
  "error": "An account with the email \"maria.schmidt@example.com\" already exists.",
  "error_name": "email_exists_error",
  "email": "maria.schmidt@example.com"
}
```

Osoba se stejným křestním jménem, příjmením, pohlavím a datem narození jako profil, který tvůj klíč vidí,
dostane `409` s `error_name: "duplicate_profile_error"`. Použij vrácené `profile_id` místo
vytváření druhého profilu:

```json theme={null}
{
  "error": "A patient named \"Maria Schmidt\", born 02-04-1990, with the same biological sex already exists as m***@example.com. Search for that patient and select them instead of creating a duplicate.",
  "error_name": "duplicate_profile_error",
  "profile_id": "3f1c2a8e-5b7d-4c9e-8a21-6d4f0b9e7c35",
  "full_name": "Maria Schmidt",
  "date_of_birth": "1990-04-02",
  "masked_email": "m***@example.com"
}
```

Příjmení v sandboxu, která generují testovací data, mají výjimku.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/profiles \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "first_name": "Maria",
    "last_name": "Schmidt",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "profile_group": "acme-clinic-berlin",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "height": 168,
    "weight": 65,
    "language": "de",
    "transactional_emails_enabled": true,
    "marketing_emails_enabled": false
  }'
```

```json 201 theme={null}
{
  "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "handle": null,
  "first_name": "Maria",
  "last_name": "Schmidt",
  "email": "maria.schmidt@example.com",
  "phone": "+4930123456789",
  "sex": 2,
  "date_of_birth": "1985-03-22",
  "height": 168,
  "weight": 65,
  "language": "de",
  "transactional_emails_enabled": true,
  "created_at": "2026-04-01T09:14:32Z",
  "updated_at": null
}
```

```json 400 theme={null}
{
  "error": "date_of_birth: Birthdate cannot be in the future."
}
```

```json 404 theme={null}
{
  "error": "Profile group 'acme-clinic-berlin' not found"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.