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

> Przewodnik krok po kroku: utwórz i zaktualizuj profile pacjentów w Aniva Partner API, zanim zarezerwujesz badanie krwi.

Skorzystaj z tego przewodnika, aby utworzyć profil pacjenta i przypisać go do swojej grupy profili. Profile są punktem wyjścia do umawiania wizyt i uruchamiania zleceń laboratoryjnych.

**1. Uzyskaj identyfikator swojej grupy profili**

Każdy profil musi być przypisany do grupy profili należącej do twojego konta partnerskiego. Pole `profile_group` przyjmuje niezmienny UUID grupy albo jej czytelny slug — UUID jest zalecany, ponieważ nigdy się nie zmienia i pozostaje aktualny po zmianie nazwy sluga.

Jeśli nie znasz identyfikatora swojej grupy profili, skontaktuj się z Aniva, aby go uzyskać. Bez prawidłowego identyfikatora nie możesz tworzyć profili.

**2. Utwórz profil**

Wyślij żądanie `POST` na adres `/api/v1/profiles` z danymi demograficznymi pacjenta.

> [!NOTE]
>
> Oba pola `first_name` i `last_name` są wymagane. Przyjmują wyłącznie litery alfabetu łacińskiego (w tym litery ze znakami diakrytycznymi, np. ü), spacje, łączniki i apostrofy. Imiona i nazwiska zapisane innym pismem poddaj transliteracji przed ich wysłaniem.

> [!NOTE]
>
> Jeśli pominiesz `email`, Aniva automatycznie wygeneruje zastępczy adres e-mail dla profilu. Możesz go później zaktualizować żądaniem `PATCH`.

> [!TIP]
>
> Pole `language` określa język, którego Aniva używa w komunikacji z pacjentem — na przykład w przypomnieniach o wizytach i powiadomieniach o wynikach. Ustaw je zgodnie z preferowanym językiem pacjenta. Obsługiwane wartości znajdziesz na stronie [Utwórz profil](https://docs.anivahealth.com/pl/api/profiles/create-profile.md). Domyślnie `en`.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/profiles \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "first_name": "Emma",
    "last_name": "Müller",
    "sex": 2,
    "date_of_birth": "1990-04-15",
    "profile_group": "my-clinic-group",
    "email": "emma.muller@example.com",
    "language": "de"
  }'
```

```javascript JavaScript theme={null}
const response = await fetch('https://anivahealth.com/api/v1/profiles', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
    first_name: 'Emma',
    last_name: 'Müller',
    sex: 2,
    date_of_birth: '1990-04-15',
    profile_group: 'my-clinic-group',
    email: 'emma.muller@example.com',
    language: 'de',
  }),
});

const profile = await response.json();
```

Pomyślne żądanie zwraca `201 Created` z obiektem nowego profilu:

```json theme={null}
{
  "id": "a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56",
  "handle": null,
  "first_name": "Emma",
  "last_name": "Müller",
  "email": "emma.muller@example.com",
  "phone": null,
  "sex": 2,
  "date_of_birth": "1990-04-15",
  "height": null,
  "weight": null,
  "language": "de",
  "transactional_emails_enabled": null,
  "created_at": "2026-04-01T09:14:22Z",
  "updated_at": null
}
```

Zapisz `id` — będzie ci potrzebne do umawiania wizyt i aktualizowania profilu.

**3. Zaktualizuj profil (opcjonalnie)**

Użyj `PATCH /api/v1/profiles/{id}`, aby zaktualizować dowolne pola profilu po jego utworzeniu. Wszystkie pola są opcjonalne — uwzględnij tylko te, które chcesz zmienić.

Poniższy przykład dodaje numer telefonu i wzrost:

```bash cURL theme={null}
curl --request PATCH \
  --url https://anivahealth.com/api/v1/profiles/a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56 \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "phone": "+4915123456789",
    "height": 168.5
  }'
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/profiles/a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56',
  {
    method: 'PATCH',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY',
    },
    body: JSON.stringify({
      phone: '+4915123456789',
      height: 168.5,
    }),
  }
);

const updated = await response.json();
```

Pomyślne żądanie zwraca `200 OK` z pełnym zaktualizowanym obiektem profilu.

## Obsługa błędów

| Status | Przyczyna | Rozwiązanie |
| - | - | - |
| `400 Bad Request` | Brakuje wymaganego pola, wartość jest poza zakresem albo `date_of_birth` jest nieprawdopodobna (w przyszłości, przed 1900 r. lub wskazująca na wiek spoza przedziału 16–100 lat). | Sprawdź treść odpowiedzi z błędem, aby znaleźć szczegółowy komunikat walidacji, i popraw żądanie. |
| `403 Forbidden` | Twój klucz API nie ma dostępu do tej operacji lub nie masz dostępu do wskazanej grupy profili. | Skontaktuj się z Aniva, aby potwierdzić uprawnienia swojego klucza API i dostęp do grupy profili. |
| `404 Not Found` | Wartość `profile_group` nie pasuje do żadnej grupy profili na twoim koncie (ani po UUID, ani po slugu). | Sprawdź, czy identyfikator jest poprawny. Skontaktuj się z Aniva, jeśli nie masz pewności co do swojego UUID lub sluga. |
| `409 Conflict` | Profil dla tego adresu `email` już istnieje (`error_name: "email_exists_error"`) albo ponownie użyto `Idempotency-Key` z inną treścią żądania. | Użyj istniejącego profilu dla tego adresu e-mail albo wyślij nowy `Idempotency-Key`. |


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