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

# Створити профіль

> Покрокова інструкція: створюй та оновлюй профілі пацієнтів в Aniva Partner API перед записом на аналіз крові.

Використовуй цей посібник, щоб створити профіль пацієнта й призначити його до своєї групи профілів. Профілі — це відправна точка для планування записів і запуску лабораторних замовлень.

**1. Отримати ідентифікатор групи профілів**

Кожен профіль має бути призначений до групи профілів, що належить твоєму партнерському акаунту. Поле `profile_group` приймає або незмінний UUID групи, або її читабельний slug — краще використовувати UUID, адже він ніколи не змінюється і зберігається після перейменування slug.

Якщо ти не знаєш ідентифікатор своєї групи профілів, звернися до Aniva, щоб його отримати. Без дійсного ідентифікатора створювати профілі неможливо.

**2. Створити профіль**

Надішли `POST`-запит на `/api/v1/profiles` із демографічними даними пацієнта.

> [!NOTE]
>
> Поля `first_name` і `last_name` є обов’язковими. Вони приймають лише літери латиниці (включно з літерами з діакритичними знаками, як-от ü), пробіли, дефіси та апострофи. Перед надсиланням транслітеруй імена, написані іншими абетками.

> [!NOTE]
>
> Якщо ти не вкажеш `email`, Aniva автоматично згенерує тимчасову електронну адресу для профілю. Її можна оновити пізніше за допомогою `PATCH`-запиту.

> [!TIP]
>
> Поле `language` визначає мову, якою Aniva спілкується з пацієнтом — наприклад, у нагадуваннях про запис і сповіщеннях про результати. Задай його відповідно до бажаної мови пацієнта. На сторінці [Створення профілю](https://docs.anivahealth.com/uk/api/profiles/create-profile.md) перелічено підтримувані значення. Типове значення — `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();
```

Успішний запит повертає `201 Created` з об’єктом нового профілю:

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

Збережи `id` — він знадобиться для планування записів і оновлення профілю.

**3. Оновити профіль (необов’язково)**

Використовуй `PATCH /api/v1/profiles/{id}`, щоб оновити будь-які поля профілю після створення. Усі поля необов’язкові — передавай лише ті, які хочеш змінити.

У наведеному нижче прикладі додаються номер телефону та зріст:

```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();
```

Успішний запит повертає `200 OK` із повним об’єктом оновленого профілю.

## Обробка помилок

| Статус | Причина | Вирішення |
| - | - | - |
| `400 Bad Request` | Відсутнє обов’язкове поле, значення виходить за допустимі межі або `date_of_birth` є неправдоподібною (у майбутньому, до 1900 року або вказує на вік поза межами 16–100 років). | Перевір тіло відповіді з помилкою, щоб побачити точне повідомлення валідації, і виправ запит. |
| `403 Forbidden` | Твій API-ключ не має доступу до цієї операції або в тебе немає доступу до вказаної групи профілів. | Звернися до Aniva, щоб підтвердити права доступу твого API-ключа та доступ до групи профілів. |
| `404 Not Found` | Значення `profile_group` не відповідає жодній групі профілів у твоєму акаунті (ні за UUID, ні за slug). | Перевір правильність ідентифікатора. Звернися до Aniva, якщо маєш сумніви щодо свого UUID або slug. |
| `409 Conflict` | Профіль для цього `email` уже існує (`error_name: "email_exists_error"`) або `Idempotency-Key` використано повторно з іншим тілом запиту. | Використай наявний профіль для цієї електронної адреси або надішли новий `Idempotency-Key`. |


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