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

# Opprett en profil

> Trinnvis veiledning: opprett og oppdater pasientprofiler i Aniva Partner API før du bestiller en blodprøve.

Bruk denne veiledningen for å opprette en pasientprofil og tilordne den til profilgruppen din. Profiler er utgangspunktet for å bestille timer og utløse labbestillinger.

**1. Hent referansen til profilgruppen din**

Hver profil må tilordnes en profilgruppe som tilhører partnerkontoen din. Feltet `profile_group` godtar enten gruppens uforanderlige UUID eller den lesbare slug-en – UUID foretrekkes fordi den aldri endres og fungerer selv om slug-en endrer navn.

Hvis du ikke kjenner referansen til profilgruppen din, kontakt Aniva for å få den. Du kan ikke opprette profiler uten en gyldig referanse.

**2. Opprett profilen**

Send en `POST`-forespørsel til `/api/v1/profiles` med pasientens demografiske data.

> [!NOTE]
>
> Både `first_name` og `last_name` er påkrevd. De godtar kun bokstaver fra det latinske alfabetet (inkludert bokstaver med aksent, som ü), mellomrom, bindestreker og apostrofer. Translitterer navn i andre skriftsystemer før du sender dem inn.

> [!NOTE]
>
> Hvis du utelater `email`, genererer Aniva automatisk en plassholder-e-postadresse for profilen. Du kan oppdatere den senere med en `PATCH`-forespørsel.

> [!TIP]
>
> Feltet `language` styrer språket Aniva bruker i kommunikasjonen med pasienten – for eksempel timepåminnelser og resultatvarsler. Sett det til pasientens foretrukne språk. [Opprett profil](https://docs.anivahealth.com/no/api/profiles/create-profile.md) viser de støttede verdiene. Standardverdien 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 forespørsel returnerer `201 Created` med det nye profilobjektet:

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

Lagre `id` – du trenger den for å bestille timer og oppdatere profilen.

**3. Oppdater profilen (valgfritt)**

Bruk `PATCH /api/v1/profiles/{id}` for å oppdatere profilfelt etter opprettelse. Alle felt er valgfrie – ta bare med feltene du vil endre.

Eksempelet nedenfor legger til telefonnummer og høyde:

```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 forespørsel returnerer `200 OK` med hele det oppdaterte profilobjektet.

## Feilhåndtering

| Status | Årsak | Løsning |
| - | - | - |
| `400 Bad Request` | Et påkrevd felt mangler, en verdi er utenfor gyldig område, eller `date_of_birth` er usannsynlig (i fremtiden, før 1900, eller tilsier en alder utenfor 16–100). | Sjekk innholdet i feilresponsen for den spesifikke valideringsmeldingen og rett opp forespørselen. |
| `403 Forbidden` | API-nøkkelen din har ikke tilgang til denne operasjonen, eller du har ikke tilgang til den angitte profilgruppen. | Kontakt Aniva for å bekrefte rettighetene til API-nøkkelen og tilgangen til profilgruppen. |
| `404 Not Found` | Verdien for `profile_group` samsvarer ikke med noen profilgruppe på kontoen din (verken via UUID eller slug). | Sjekk at referansen er riktig. Kontakt Aniva hvis du er usikker på UUID-en eller slug-en din. |
| `409 Conflict` | Det finnes allerede en profil for denne `email`-adressen (`error_name: "email_exists_error"`), eller en `Idempotency-Key` ble gjenbrukt med annet innhold. | Bruk den eksisterende profilen for den e-postadressen, eller send en ny `Idempotency-Key`. |


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