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

# Creează un profil

> Creează un profil nou de pacient și atribuie-l unui grup de profiluri

Creează un profil nou de pacient și atribuie-l unui grup de profiluri. Profilul stochează date demografice utilizate în programări și comenzi de laborator.

Necesită scope-ul `create_user`.

Trimite un antet opțional `Idempotency-Key` pentru ca această creare să poată fi reîncercată în siguranță — repetarea aceleiași chei returnează răspunsul inițial în loc să creeze încă una. Vezi [Idempotență](https://docs.anivahealth.com/ro/concepts/idempotency.md).

## Cerere

### Parametri de corp

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

Prenumele pacientului. Trebuie să folosească caractere latine, între 1 și 100 de caractere.

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

Numele de familie al pacientului. Trebuie să folosească caractere latine, între 1 și 100 de caractere. Laboratoarele resping
comenzile pentru un pacient fără nume de familie, așa că un profil nu poate fi creat fără acesta.

Trei valori sunt rezervate pentru a genera date de test — vezi [Date de test pentru sandbox](#date-de-test-pentru-sandbox).

**sex** `integer` *required*

Sexul biologic conform ISO/IEC 5218. Folosește `1` pentru masculin, `2` pentru feminin. Laboratorul are nevoie de acesta pentru
intervalele de referință, așa că `0` (necunoscut) returnează `400`. Obligatoriu, cu excepția cazului în care grupul tău de profiluri îi permite
pacientului să îl introducă pe pagina de activare a kitului. În acest caz, omite-l. Vezi
[Lasă pacientul să introducă data nașterii și sexul](https://docs.anivahealth.com/ro/concepts/profiles.md#permite-pacientului-sa-introduca-data-nasterii-si-sexul).

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

Data nașterii în format `YYYY-MM-DD`. Trebuie să fie în trecut și nu înainte de 1900. Vârsta rezultată
trebuie să fie între 16 și 100 de ani. Alte valori returnează `400`. Obligatoriu, cu excepția cazului în care grupul tău de profiluri îi permite
pacientului să o introducă pe pagina de activare a kitului. În acest caz, omite-o.

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

Referință polimorfică (UUID sau slug) către grupul de profiluri căruia să îi fie atribuit acest profil. UUID-ul este
identificatorul imuabil și rămâne valabil la redenumirea slug-ului; slug-ul rămâne acceptat pentru integrările de marketing și ale
partenerilor construite pe identificatori lizibili. UUID-ul este preferat. Grupul de profiluri trebuie să se afle
în contextul de acces al cheii tale API. Obligatoriu, cu excepția cazului în care trimiți parametrul învechit
`profile_group_slug`.

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

Învechit: folosește `profile_group`. Slug-ul grupului de profiluri. Doar litere mici, cifre, cratime și
liniuțe de subliniere.

**email** `string`

Adresa de e-mail a profilului. Dacă lipsește, Aniva generează automat o adresă de e-mail.

Furnizarea `email` face și crearea **sigură la reîncercări**: o adresă poate avea un singur profil, astfel încât
o cerere repetată returnează `409` în loc de un al doilea profil. Adresele generate automat sunt unice per
cerere. Trimite `email` sau un `Idempotency-Key` dacă integrarea ta reîncearcă cererile.

**phone** `string`

Număr de telefon în format E.164 (de ex., `+14155552671`).

**height** `number`

Înălțimea în centimetri.

**weight** `number`

Greutatea în kilograme.

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

Limba preferată pentru profil: `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` sau `uk`. Valoarea implicită este `en`.

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

Indică dacă acest profil trebuie să primească e-mailuri tranzacționale (programatice) — confirmări de
programare, notificări privind disponibilitatea rezultatelor etc. Suprascrie setarea implicită a grupului de profiluri. Distinct de
consimțământul de marketing. Omite pentru a folosi setarea implicită.

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

Indică dacă acest profil optează pentru e-mailuri de marketing (newslettere, actualizări de produs). Suprascrie
setarea implicită a grupului de profiluri. Distinct de e-mailurile tranzacționale. Omite pentru a folosi setarea implicită a grupului de profiluri.
Doar scriere: nu este returnat în răspunsul profilului.

## Date de test pentru sandbox

Fiecare cale de citire care merită testată — [Listează programările](https://docs.anivahealth.com/ro/api/appointments/list-appointments.md),
[Obține rezultatele](https://docs.anivahealth.com/ro/api/appointments/get-results.md),
[Descarcă document](https://docs.anivahealth.com/ro/api/documents/download-document.md) — este goală până când are loc o recoltare de sânge reală
câteva zile mai târziu. Acest lucru face ca un test automat de integrare să fie incomod de scris.

Trei valori `last_name` sunt rezervate pentru a rezolva această problemă. Creează un profil cu una dintre ele, iar Aniva
prepopulează starea descrisă mai jos înainte de a răspunde, astfel încât următorul tău apel o vede deja:

| `last_name` | Ce primește profilul |
| - | - |
| `Upcomingtestmann` | O programare viitoare `confirmed` cu un panel atașat. Încă fără rezultate. |
| `Partialtestmann` | O programare trecută `blood_drawn`. Aproximativ **jumătate** din panel este raportat; [Obține rezultatele](https://docs.anivahealth.com/ro/api/appointments/get-results.md) este `in_progress`. |
| `Fulltestmann` | O programare trecută `blood_drawn`. **Fiecare** biomarker din panel este raportat, `status: "completed"` și un PDF cu raportul de laborator în `documents[]`. |

Potrivirea nu ține cont de majuscule și minuscule. Orice alt câmp — inclusiv `date_of_birth` și `sex` — este stocat și
folosit normal, astfel încât intervalele de referință pe care le primești sunt cele reale, specifice vârstei și sexului, pentru
profilul pe care l-ai creat.

Programarea este făcută la locația **Aniva Test**, într-un interval real disponibil peste cel puțin cinci
zile (sau cu cinci zile în urmă, pentru stările trecute). Popularea acesteia nu plasează nicio comandă de laborator și nu rezervă niciun
curier.

> [!NOTE]
>
> Folosește o adresă pe care o controlezi pentru profilurile de test. Mementourile de programare Aniva se bazează pe
> `scheduled_at`, așa că setul de date pentru programări viitoare le va trimite, dacă profilul nu este dezabonat prin
> `transactional_emails_enabled: false`.

Panelul este ales aleatoriu dintre cele pe care le poate vedea cheia ta API, așa că `panel_id` al acestuia se regăsește întotdeauna
în propriul tău [Listează panelurile](https://docs.anivahealth.com/ro/api/panels/list-panels.md). Biomarkerii clinici primesc o valoare din
intervalul de referință al biomarkerului; genele primesc un genotip aleatoriu din datele de referință Aniva, de unde rezultă variantele corespunzătoare, semnificația clinică și ID-urile rs.

> [!NOTE]
>
> Panelul și valorile sunt regenerate la fiecare creare, așa că verifică structura, nu un anumit
> panel sau numere exacte.

## Răspuns

În caz de succes, API-ul returnează `201 Created` împreună cu profilul nou creat.

**id** `string` *required*

Identificator unic al profilului (UUID).

**handle** `string`

Handle-ul profilului sau numele de utilizator. Poate fi `null`.

**first\_name** `string`

Prenume. Poate fi `null`.

**last\_name** `string`

Nume de familie. Poate fi `null`.

**email** `string`

Adresă de e-mail. Poate fi `null`.

**phone** `string`

Număr de telefon în format E.164. Poate fi `null`.

**sex** `integer`

Sex biologic conform ISO/IEC 5218 (`0` = necunoscut, `1` = masculin, `2` = feminin). Poate fi `null`.

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

Data nașterii în format `YYYY-MM-DD`. Poate fi `null`.

**height** `number`

Înălțime în centimetri. Poate fi `null`.

**weight** `number`

Greutate în kilograme. Poate fi `null`.

**language** `string`

Limba preferată, unul dintre cele 32 de coduri de mai sus.

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

Indică dacă acest profil primește e-mailuri tranzacționale (programatice). `null` dacă nu a fost setat niciodată.

**created\_at** `string`

Marcaj temporal ISO 8601 al creării profilului.

**updated\_at** `string`

Marcaj temporal ISO 8601 al ultimei actualizări. `null` pentru profilurile nou create.

## Răspunsuri de eroare

| Status | Descriere |
| - | - |
| `400` | Eroare de validare — unul sau mai multe câmpuri nu au trecut validarea. |
| `403` | Interzis — cheia ta API nu are acces la această operațiune sau grupul de profiluri nu face parte din contextul tău de acces. |
| `404` | Grupul de profiluri nu a fost găsit. |
| `409` | Există deja un profil pentru adresa `email` furnizată (răspunsul conține adresa) sau pentru aceeași persoană (vezi mai jos), ori `Idempotency-Key` a fost reutilizat cu un alt corp al cererii sau cererea inițială nu s-a finalizat. |
| `500` | Eroare internă de server. |

Un răspuns `409` arată astfel — tratează-l ca „acest profil există deja” și caută-l cu
[Listează profilurile](https://docs.anivahealth.com/ro/api/profiles/list-profiles.md) (`?email=`) în loc să reîncerci crearea:

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

O persoană cu același prenume, nume de familie, sex și aceeași dată de naștere ca un profil pe care îl poate vedea cheia ta
primește `409` cu `error_name: "duplicate_profile_error"`. Folosește `profile_id` returnat în loc
să creezi un al doilea 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"
}
```

Numele de familie din sandbox care generează date de test sunt exceptate.

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