> ## 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.

# Utwórz profil

> Utwórz nowy profil pacjenta i przypisz go do grupy profili

Utwórz nowy profil pacjenta i przypisz go do grupy profili. Profil przechowuje dane demograficzne wykorzystywane w wizytach i zleceniach laboratoryjnych.

Wymaga zakresu `create_user`.

Wyślij opcjonalny nagłówek `Idempotency-Key`, aby ponawianie tego żądania utworzenia było bezpieczne — powtórzenie tego samego klucza zwraca pierwotną odpowiedź zamiast tworzyć kolejną wizytę. Zobacz [Idempotentność](https://docs.anivahealth.com/pl/concepts/idempotency.md).

## Żądanie

### Parametry treści

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

Imię pacjenta. Musi zawierać znaki łacińskie, od 1 do 100 znaków.

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

Nazwisko pacjenta. Musi zawierać znaki łacińskie, od 1 do 100 znaków. Laboratoria odrzucają
zlecenia dla pacjenta bez nazwiska, więc bez niego nie można utworzyć profilu.

Trzy wartości są zarezerwowane dla danych testowych — zobacz [Dane testowe w środowisku sandbox](#dane-testowe-w-srodowisku-sandbox).

**sex** `integer` *required*

Płeć biologiczna według ISO/IEC 5218. Użyj `1` dla mężczyzny, `2` dla kobiety. Laboratorium
potrzebuje tej informacji do określenia zakresów referencyjnych, więc `0` (nieznana) zwraca `400`.
Wymagane, chyba że twoja grupa profili pozwala pacjentowi podać płeć na stronie aktywacji zestawu.
Wtedy pomiń to pole. Zobacz
[Pozwól pacjentowi podać datę urodzenia i płeć](https://docs.anivahealth.com/pl/concepts/profiles.md#pozwol-pacjentowi-wpisac-date-urodzenia-i-plec).

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

Data urodzenia w formacie `YYYY-MM-DD`. Musi być w przeszłości i nie przed 1900 rokiem. Wynikający
z niej wiek musi mieścić się w przedziale od 16 do 100 lat. Inne wartości zwracają `400`. Wymagane,
chyba że twoja grupa profili pozwala pacjentowi podać ją na stronie aktywacji zestawu. Wtedy pomiń
to pole.

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

Polimorficzne odniesienie (UUID lub slug) do grupy profili, do której chcesz przypisać ten profil.
UUID jest niezmiennym identyfikatorem i pozostaje ważny po zmianie sluga; slug nadal jest
akceptowany w integracjach marketingowych i partnerskich opartych na czytelnych identyfikatorach.
Preferowany jest UUID. Grupa profili musi znajdować się w kontekście dostępu twojego klucza API.
Wymagane, chyba że wysyłasz przestarzałe pole `profile_group_slug`.

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

Przestarzałe: użyj `profile_group`. Slug grupy profili. Tylko małe litery, cyfry, łączniki i
podkreślenia.

**email** `string`

Adres e-mail dla profilu. Jeśli go pominiesz, Aniva wygeneruje adres e-mail automatycznie.

Podanie pola `email` sprawia też, że utworzenie profilu jest **bezpieczne przy ponawianiu**: jeden
adres może mieć tylko jeden profil, więc powtórzone żądanie zwraca `409` zamiast drugiego profilu.
Automatycznie generowane adresy są unikalne dla każdego żądania. Wyślij `email` lub nagłówek
`Idempotency-Key`, jeśli twoja integracja ponawia żądania.

**phone** `string`

Numer telefonu w formacie E.164 (np. `+14155552671`).

**height** `number`

Wzrost w centymetrach.

**weight** `number`

Waga w kilogramach.

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

Preferowany język 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` lub `uk`. Domyślnie `en`.

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

Czy ten profil ma otrzymywać e-maile transakcyjne (automatyczne) — potwierdzenia wizyt,
powiadomienia o gotowych wynikach itp. Nadpisuje ustawienie domyślne grupy profili. Niezależne od
zgody marketingowej. Pomiń, aby użyć ustawienia domyślnego.

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

Czy ten profil wyraża zgodę na e-maile marketingowe (newslettery, informacje o nowościach).
Nadpisuje ustawienie domyślne grupy profili. Niezależne od e-maili transakcyjnych. Pomiń, aby
użyć ustawienia domyślnego grupy profili. Tylko do zapisu: nie jest zwracane w odpowiedzi profilu.

## Dane testowe w środowisku sandbox

Każda ścieżka odczytu warta przetestowania — [Wyświetl wizyty](https://docs.anivahealth.com/pl/api/appointments/list-appointments.md),
[Pobierz wyniki](https://docs.anivahealth.com/pl/api/appointments/get-results.md),
[Pobierz dokument](https://docs.anivahealth.com/pl/api/documents/download-document.md) — jest pusta, dopóki kilka dni później nie
odbędzie się prawdziwe pobranie krwi. To utrudnia napisanie automatycznego testu integracyjnego.

Aby to rozwiązać, zarezerwowano trzy wartości `last_name`. Utwórz profil z jedną z nich, a Aniva
przed wysłaniem odpowiedzi wstępnie wypełni stan opisany poniżej, więc twoje kolejne wywołanie od
razu go zobaczy:

| `last_name` | Co otrzymuje profil |
| - | - |
| `Upcomingtestmann` | Jedna nadchodząca wizyta ze statusem `confirmed` i przypisanym panelem. Jeszcze bez wyników. |
| `Partialtestmann` | Jedna przeszła wizyta ze statusem `blood_drawn`. Zaraportowana jest mniej więcej **połowa** panelu; [Pobierz wyniki](https://docs.anivahealth.com/pl/api/appointments/get-results.md) ma status `in_progress`. |
| `Fulltestmann` | Jedna przeszła wizyta ze statusem `blood_drawn`. Zaraportowany jest **każdy** biomarker z panelu, `status: "completed"` oraz raport laboratoryjny PDF w `documents[]`. |

Dopasowanie nie uwzględnia wielkości liter. Każde inne pole — w tym `date_of_birth` i `sex` — jest
zapisywane i używane normalnie, więc otrzymywane zakresy referencyjne to rzeczywiste zakresy
dopasowane do wieku i płci utworzonego profilu.

Wizyta jest rezerwowana w lokalizacji **Aniva Test**, w rzeczywistym wolnym terminie za co najmniej pięć dni
(lub pięć dni temu w przypadku stanów przeszłych). Jej wygenerowanie nie składa zlecenia laboratoryjnego i nie zamawia
kuriera.

> [!NOTE]
>
> Podaj w profilach testowych adres, który kontrolujesz. Przypomnienia o wizytach w Aniva zależą od
> `scheduled_at`, więc zestaw testowy dla nadchodzącej wizyty je wyśle, chyba że wyłączysz je w profilu przez
> `transactional_emails_enabled: false`.

Panel jest wybierany losowo spośród tych, które widzi twój klucz API, więc jego `panel_id` zawsze odpowiada pozycji
z twojej [Listy paneli](https://docs.anivahealth.com/pl/api/panels/list-panels.md). Biomarkery kliniczne otrzymują wartość z
zakresu referencyjnego danego biomarkera; geny otrzymują losowy genotyp z danych referencyjnych Aniva wraz z wynikającymi z niego pasującymi wariantami, znaczeniem klinicznym i identyfikatorami rs.

> [!NOTE]
>
> Panel i wartości są generowane na nowo przy każdym utworzeniu, więc w testach sprawdzaj strukturę, a nie konkretny
> panel czy dokładne liczby.

## Odpowiedź

Po pomyślnym wykonaniu API zwraca `201 Created` z nowo utworzonym profilem.

**id** `string` *required*

Unikalny identyfikator profilu (UUID).

**handle** `string`

Handle lub nazwa użytkownika profilu. Może mieć wartość `null`.

**first\_name** `string`

Imię. Może mieć wartość `null`.

**last\_name** `string`

Nazwisko. Może mieć wartość `null`.

**email** `string`

Adres e-mail. Może mieć wartość `null`.

**phone** `string`

Numer telefonu w formacie E.164. Może mieć wartość `null`.

**sex** `integer`

Płeć biologiczna wg ISO/IEC 5218 (`0` = nieznana, `1` = męska, `2` = żeńska). Może mieć wartość `null`.

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

Data urodzenia w formacie `YYYY-MM-DD`. Może mieć wartość `null`.

**height** `number`

Wzrost w centymetrach. Może mieć wartość `null`.

**weight** `number`

Masa ciała w kilogramach. Może mieć wartość `null`.

**language** `string`

Preferowany język, jeden z 32 powyższych kodów.

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

Czy ten profil otrzymuje e-maile transakcyjne (automatyczne). `null`, jeśli nigdy nie ustawiono.

**created\_at** `string`

Znacznik czasu ISO 8601 utworzenia profilu.

**updated\_at** `string`

Znacznik czasu ISO 8601 ostatniej aktualizacji. `null` dla nowo utworzonych profili.

## Odpowiedzi z błędami

| Status | Opis |
| - | - |
| `400` | Błąd walidacji — co najmniej jedno pole nie przeszło walidacji. |
| `403` | Brak dostępu — twój klucz API nie ma uprawnień do tej operacji lub grupa profili znajduje się poza twoim kontekstem dostępu. |
| `404` | Nie znaleziono grupy profili. |
| `409` | Profil dla podanego `email` już istnieje (odpowiedź zawiera ten adres) lub istnieje dla tej samej osoby (patrz niżej), albo `Idempotency-Key` użyto ponownie z inną treścią żądania, albo jego pierwotne żądanie jeszcze się nie zakończyło. |
| `500` | Wewnętrzny błąd serwera. |

Odpowiedź `409` wygląda tak — potraktuj ją jako „ten profil już istnieje” i wyszukaj go za pomocą
[Listy profili](https://docs.anivahealth.com/pl/api/profiles/list-profiles.md) (`?email=`) zamiast ponawiać tworzenie:

```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 o takim samym imieniu, nazwisku, płci i dacie urodzenia jak profil widoczny dla twojego klucza
otrzymuje `409` z `error_name: "duplicate_profile_error"`. Użyj zwróconego `profile_id` zamiast
tworzyć drugi profil:

```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"
}
```

Nazwiska w środowisku sandbox, które generują dane testowe, są z tego wyłączone.

```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.