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

> Trin-for-trin-guide: opret og opdater patientprofiler i Aniva Partner API, før du booker en blodprøve.

Brug denne guide til at oprette en patientprofil og tilknytte den til din profilgruppe. Profiler er udgangspunktet for at booke tider og udløse laboratorieordrer.

**1. Find din profilgruppereference**

Hver profil skal tilknyttes en profilgruppe, der tilhører din partnerkonto. Feltet `profile_group` accepterer enten gruppens uforanderlige UUID eller dens læsbare slug — UUID foretrækkes, fordi den aldrig ændrer sig og overlever omdøbninger af sluggen.

Hvis du ikke kender din profilgruppereference, skal du kontakte Aniva for at få den oplyst. Du kan ikke oprette profiler uden en gyldig reference.

**2. Opret profilen**

Send en `POST`-anmodning til `/api/v1/profiles` med patientens demografiske data.

> [!NOTE]
>
> Både `first_name` og `last_name` er påkrævede. De accepterer kun bogstaver fra det latinske alfabet (herunder bogstaver med accent som ü), mellemrum, bindestreger og apostroffer. Translitterér navne i andre skriftsystemer, før du sender dem.

> [!NOTE]
>
> Hvis du udelader `email`, genererer Aniva automatisk en midlertidig e-mailadresse til profilen. Du kan opdatere den senere med en `PATCH`-anmodning.

> [!TIP]
>
> Feltet `language` styrer, hvilket sprog Aniva bruger i kommunikationen med patienten – for eksempel påmindelser om tider og notifikationer om resultater. Sæt det til patientens foretrukne sprog. [Opret profil](https://docs.anivahealth.com/da/api/profiles/create-profile.md) viser de understøttede værdier. Standard er `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();
```

En vellykket anmodning returnerer `201 Created` med det nye profilobjekt:

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

Gem `id` — du skal bruge det til at booke tider og opdatere profilen.

**3. Opdater profilen (valgfrit)**

Brug `PATCH /api/v1/profiles/{id}` til at opdatere profilfelter efter oprettelse. Alle felter er valgfrie — medtag kun de felter, du vil ændre.

Følgende eksempel tilføjer et telefonnummer og højde:

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

En vellykket anmodning returnerer `200 OK` med det fulde opdaterede profilobjekt.

## Fejlhåndtering

| Status | Årsag | Løsning |
| - | - | - |
| `400 Bad Request` | Et påkrævet felt mangler, en værdi er uden for det tilladte område, eller `date_of_birth` er usandsynlig (i fremtiden, før 1900 eller giver en alder uden for 16–100). | Tjek fejlsvarets body for den specifikke valideringsbesked, og ret anmodningen. |
| `403 Forbidden` | Din API-nøgle har ikke adgang til denne handling, eller du har ikke adgang til den angivne profilgruppe. | Kontakt Aniva for at bekræfte tilladelserne for din API-nøgle og adgang til profilgruppen. |
| `404 Not Found` | Værdien for `profile_group` matcher ingen profilgruppe på din konto (hverken via UUID eller slug). | Tjek, at referencen er korrekt. Kontakt Aniva, hvis du er i tvivl om din UUID eller slug. |
| `409 Conflict` | Der findes allerede en profil for denne `email` (`error_name: "email_exists_error"`), eller en `Idempotency-Key` blev genbrugt med en anden body. | Brug den eksisterende profil for den e-mailadresse, eller send en ny `Idempotency-Key`. |


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