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

# Opret profil

> Opret en ny patientprofil, og knyt den til en profilgruppe

Opret en ny patientprofil, og tildel den til en profilgruppe. Profilen indeholder demografiske data, der bruges på tværs af tider og laboratoriebestillinger.

Kræver scopet `create_user`.

Send en valgfri `Idempotency-Key`-header for at gøre denne oprettelse sikker at prøve igen — gentages den samme nøgle, returneres det oprindelige svar i stedet for at oprette endnu en. Se [Idempotens](https://docs.anivahealth.com/da/concepts/idempotency.md).

## Forespørgsel

### Body-parametre

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

Patientens fornavn. Skal bruge latinske tegn, mellem 1 og 100 tegn.

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

Patientens efternavn. Skal bruge latinske tegn, mellem 1 og 100 tegn. Laboratorier afviser
bestillinger for en patient uden efternavn, så en profil kan ikke oprettes uden.

Tre værdier er reserveret til at oprette testdata – se [Sandbox-testdata](#sandbox-testdata).

**sex** `integer` *required*

Biologisk køn efter ISO/IEC 5218. Brug `1` for mand, `2` for kvinde. Laboratoriet skal bruge det til
referenceintervallerne, så `0` (ukendt) returnerer `400`. Påkrævet, medmindre din profilgruppe lader
patienten indtaste det på aktiveringssiden for kittet. Udelad det i så fald. Se
[Lad patienten indtaste fødselsdato og køn](https://docs.anivahealth.com/da/concepts/profiles.md#lad-patienten-indtaste-fodselsdato-og-kon).

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

Fødselsdato i formatet `YYYY-MM-DD`. Skal ligge i fortiden og ikke før 1900. Den beregnede alder
skal være mellem 16 og 100 år. Andre værdier returnerer `400`. Påkrævet, medmindre din profilgruppe lader
patienten indtaste den på aktiveringssiden for kittet. Udelad den i så fald.

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

Polymorfisk reference (UUID eller slug) til den profilgruppe, profilen skal tildeles. UUID'et er
det uforanderlige id og overlever omdøbning af slug; slug accepteres fortsat til marketing- og
partnerintegrationer baseret på læsbare id'er. UUID foretrækkes. Profilgruppen skal ligge
inden for din API-nøgles adgangskontekst. Påkrævet, medmindre du sender den udfasede
`profile_group_slug`.

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

Udfaset: brug `profile_group`. Profilgruppens slug. Kun små bogstaver, cifre, bindestreger og
understreger.

**email** `string`

E-mailadresse for profilen. Hvis den udelades, genererer Aniva automatisk en e-mailadresse.

At angive `email` gør også oprettelsen **sikker ved genforsøg**: en adresse kan kun have én profil, så
en gentaget anmodning returnerer `409` i stedet for endnu en profil. Autogenererede adresser er unikke pr.
anmodning. Send `email` eller en `Idempotency-Key`, hvis din integration forsøger igen.

**phone** `string`

Telefonnummer i E.164-format (f.eks. `+14155552671`).

**height** `number`

Højde i centimeter.

**weight** `number`

Vægt i kilogram.

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

Foretrukket sprog for profilen: `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` eller `uk`. Standard er `en`.

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

Om denne profil skal modtage transaktionelle (automatiske) e-mails –
tidsbekræftelser, besked når resultaterne er klar osv. Tilsidesætter profilgruppens standard. Adskilt fra
samtykke til markedsføring. Udelad for at bruge standarden.

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

Om denne profil tilmelder sig markedsføringsmails (nyhedsbreve, produktopdateringer). Tilsidesætter
profilgruppens standard. Adskilt fra transaktionelle e-mails. Udelad for at bruge profilgruppens standard.
Kun skrivning: returneres ikke i profilsvaret.

## Sandbox-testdata

Alle læse-endpoints, der er værd at teste – [Vis tider](https://docs.anivahealth.com/da/api/appointments/list-appointments.md),
[Hent resultater](https://docs.anivahealth.com/da/api/appointments/get-results.md),
[Download dokument](https://docs.anivahealth.com/da/api/documents/download-document.md) – er tomme, indtil en rigtig blodprøvetagning finder sted
dage senere. Det gør en automatiseret integrationstest besværlig at skrive.

Tre `last_name`-værdier er reserveret til at løse det. Opret en profil med en af dem, så
forudfylder Aniva den tilstand, der er beskrevet nedenfor, før svaret sendes, så dit næste kald allerede ser den:

| `last_name` | Hvad profilen får |
| - | - |
| `Upcomingtestmann` | Én kommende `confirmed`-tid med et tilknyttet panel. Ingen resultater endnu. |
| `Partialtestmann` | Én overstået `blood_drawn`-tid. Cirka **halvdelen** af panelet er rapporteret; [Hent resultater](https://docs.anivahealth.com/da/api/appointments/get-results.md) er `in_progress`. |
| `Fulltestmann` | Én overstået `blood_drawn`-tid. **Alle** biomarkører i panelet er rapporteret, `status: "completed"`, og en laboratorierapport som PDF i `documents[]`. |

Matchningen skelner ikke mellem store og små bogstaver. Alle andre felter – inklusive `date_of_birth` og `sex` – gemmes og
bruges som normalt, så de referenceintervaller, du får tilbage, er de rigtige alders- og kønsspecifikke for den
profil, du har oprettet.

Tiden bookes på lokationen **Aniva Test** i et reelt ledigt tidsrum mindst fem dage
fra nu (eller fem dage siden for tidligere tilstande). Oprettelsen afgiver ingen laboratoriebestilling og booker ingen
kurér.

> [!NOTE]
>
> Giv testprofiler en adresse, du selv kontrollerer. Anivas påmindelser om tider styres af
> `scheduled_at`, så testdataene for en kommende tid sender dem, medmindre profilen er frameldt via
> `transactional_emails_enabled: false`.

Panelet vælges tilfældigt blandt dem, din API-nøgle kan se, så dets `panel_id` altid kan slås op
via dit eget [Vis paneler](https://docs.anivahealth.com/da/api/panels/list-panels.md). Kliniske biomarkører får en værdi inden for
biomarkørens referenceinterval; gener får en tilfældig genotype fra Anivas referencedata, hvor de tilhørende varianter, den kliniske betydning og rs-id'er følger af den.

> [!NOTE]
>
> Panel og værdier genereres på ny ved hver oprettelse, så tjek strukturen frem for et bestemt
> panel eller nøjagtige tal.

## Svar

Ved succes returnerer API'et `201 Created` med den nyoprettede profil.

**id** `string` *required*

Unikt profil-id (UUID).

**handle** `string`

Profil-handle eller brugernavn. Kan være `null`.

**first\_name** `string`

Fornavn. Kan være `null`.

**last\_name** `string`

Efternavn. Kan være `null`.

**email** `string`

E-mailadresse. Kan være `null`.

**phone** `string`

Telefonnummer i E.164-format. Kan være `null`.

**sex** `integer`

Biologisk køn efter ISO/IEC 5218 (`0` = ukendt, `1` = mand, `2` = kvinde). Kan være `null`.

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

Fødselsdato i `YYYY-MM-DD`-format. Kan være `null`.

**height** `number`

Højde i centimeter. Kan være `null`.

**weight** `number`

Vægt i kilogram. Kan være `null`.

**language** `string`

Foretrukket sprog, en af de 32 koder ovenfor.

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

Om denne profil modtager transaktionelle (automatiske) e-mails. `null`, hvis den aldrig er angivet.

**created\_at** `string`

ISO 8601-tidsstempel for, hvornår profilen blev oprettet.

**updated\_at** `string`

ISO 8601-tidsstempel for seneste opdatering. `null` for nyoprettede profiler.

## Fejlsvar

| Status | Beskrivelse |
| - | - |
| `400` | Valideringsfejl — et eller flere felter bestod ikke valideringen. |
| `403` | Forbudt — din API-nøgle har ikke adgang til denne handling, eller profilgruppen ligger uden for din adgangskontekst. |
| `404` | Profilgruppen blev ikke fundet. |
| `409` | Der findes allerede en profil for den angivne `email` (svaret indeholder adressen) eller for den samme person (se nedenfor), eller `Idempotency-Key` blev genbrugt med en anden body, eller den oprindelige anmodning er endnu ikke afsluttet. |
| `500` | Intern serverfejl. |

En `409` ser sådan ud — betragt den som "denne profil findes allerede", og slå den op med
[Vis profiler](https://docs.anivahealth.com/da/api/profiles/list-profiles.md) (`?email=`) i stedet for at forsøge oprettelsen igen:

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

En person med samme fornavn, efternavn, køn og fødselsdato som en profil, din nøgle kan se,
får en `409` med `error_name: "duplicate_profile_error"`. Brug det returnerede `profile_id` i stedet for
at oprette en ny 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"
}
```

Efternavnene i sandkassen, der opretter testdata, er undtaget.

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