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

> Opprett en ny pasientprofil og tilordne den til en profilgruppe

Opprett en ny pasientprofil og tilordne den til en profilgruppe. Profilen inneholder demografiske data som brukes på tvers av timer og labbestillinger.

Krever scope-et `create_user`.

Send en valgfri `Idempotency-Key`-header for å gjøre denne opprettelsen trygg å prøve på nytt — hvis samme nøkkel sendes igjen, returneres det opprinnelige svaret i stedet for å opprette en til. Se [Idempotens](https://docs.anivahealth.com/no/concepts/idempotency.md).

## Forespørsel

### Body-parametere

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

Fornavnet til pasienten. Må bruke latinske tegn, mellom 1 og 100 tegn.

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

Etternavnet til pasienten. Må bruke latinske tegn, mellom 1 og 100 tegn. Laboratorier avviser
bestillinger for en pasient uten etternavn, så en profil kan ikke opprettes uten.

Tre verdier er reservert for å opprette testdata — se [Testdata i sandkassen](#testdata-i-sandkassen).

**sex** `integer` *required*

Biologisk kjønn etter ISO/IEC 5218. Bruk `1` for mann, `2` for kvinne. Laboratoriet trenger det for
referanseområdene, så `0` (ukjent) returnerer `400`. Påkrevd, med mindre profilgruppen din lar
pasienten oppgi det på siden for aktivering av testsettet. Utelat det i så fall. Se
[La pasienten oppgi fødselsdato og kjønn](https://docs.anivahealth.com/no/concepts/profiles.md#la-pasienten-oppgi-fodselsdato-og-kjonn).

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

Fødselsdato i formatet `YYYY-MM-DD`. Må være i fortiden og ikke før 1900. Den beregnede alderen
må være mellom 16 og 100 år. Andre verdier returnerer `400`. Påkrevd, med mindre profilgruppen din lar
pasienten oppgi det på siden for aktivering av testsettet. Utelat det i så fall.

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

Polymorf referanse (UUID eller slug) til profilgruppen denne profilen skal tilordnes. UUID-en er
den uforanderlige identifikatoren og overlever navneendringer på slug-en; slug-en godtas fortsatt for markedsføring og
partnerintegrasjoner som bygger på lesbare identifikatorer. UUID foretrekkes. Profilgruppen må ligge
innenfor tilgangskonteksten til API-nøkkelen din. Påkrevd med mindre du sender den utdaterte
`profile_group_slug`.

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

Utdatert: bruk `profile_group`. Slug for profilgruppen. Kun små bokstaver, sifre, bindestreker og
understreker.

**email** `string`

E-postadresse for profilen. Hvis den utelates, genererer Aniva automatisk en e-postadresse.

Å oppgi `email` gjør også opprettelsen **trygg ved nye forsøk**: en adresse kan bare ha én profil, så
en gjentatt forespørsel returnerer `409` i stedet for en ny profil. Automatisk genererte adresser er unike per
forespørsel. Send `email` eller en `Idempotency-Key` hvis integrasjonen din prøver på nytt.

**phone** `string`

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

**height** `number`

Høyde i centimeter.

**weight** `number`

Vekt i kilogram.

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

Foretrukket språk 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`. Standardverdien er `en`.

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

Om denne profilen skal motta transaksjonelle (automatiske) e-poster — timebekreftelser,
varsler om klare resultater osv. Overstyrer standarden for profilgruppen. Skilt fra
samtykke til markedsføring. Utelat for å bruke standarden.

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

Om denne profilen samtykker til markedsførings-e-poster (nyhetsbrev, produktoppdateringer). Overstyrer
standarden for profilgruppen. Skilt fra transaksjonelle e-poster. Utelat for å bruke standarden for profilgruppen.
Kun skriving: returneres ikke i profilsvaret.

## Testdata i sandkassen

Alle leseendepunkter som er verdt å teste — [List opp timer](https://docs.anivahealth.com/no/api/appointments/list-appointments.md),
[Hent resultater](https://docs.anivahealth.com/no/api/appointments/get-results.md),
[Last ned dokument](https://docs.anivahealth.com/no/api/documents/download-document.md) — er tomme helt til en faktisk blodprøvetaking skjer
flere dager senere. Det gjør det upraktisk å skrive en automatisert integrasjonstest.

Tre `last_name`-verdier er reservert for å løse dette. Opprett en profil med én av dem, så
forhåndsutfyller Aniva tilstanden beskrevet nedenfor før det svarer, slik at neste kall allerede ser den:

| `last_name` | Hva profilen får |
| - | - |
| `Upcomingtestmann` | Én kommende `confirmed`-time med et tilknyttet panel. Ingen resultater ennå. |
| `Partialtestmann` | Én tidligere `blood_drawn`-time. Omtrent **halvparten** av panelet er rapportert; [Hent resultater](https://docs.anivahealth.com/no/api/appointments/get-results.md) er `in_progress`. |
| `Fulltestmann` | Én tidligere `blood_drawn`-time. **Hver** biomarkør i panelet er rapportert, `status: "completed"`, og en labrapport som PDF i `documents[]`. |

Samsvar skiller ikke mellom store og små bokstaver. Alle andre felter — inkludert `date_of_birth` og `sex` — lagres og
brukes som normalt, så referanseområdene du får tilbake er de faktiske alders- og kjønnsspesifikke for
profilen du opprettet.

Timen bestilles på stedet **Aniva Test**, på et faktisk bestillbart tidspunkt minst fem dager
fra nå (eller for fem dager siden for tidligere tilstander). Å opprette den sender ingen labbestilling og bestiller ikke
bud.

> [!NOTE]
>
> Gi testprofiler en adresse du kontrollerer. Anivas timepåminnelser styres av
> `scheduled_at`, så testdataene for kommende time sender dem med mindre profilen er meldt av via
> `transactional_emails_enabled: false`.

Panelet velges tilfeldig blant dem API-nøkkelen din har tilgang til, så `panel_id` alltid kan slås opp
mot din egen [List opp paneler](https://docs.anivahealth.com/no/api/panels/list-panels.md). Kliniske biomarkører får en verdi innenfor
biomarkørens referanseområde; gener får en tilfeldig genotype fra Anivas referansedata, med tilhørende varianter, klinisk betydning og rs-ID-er som følger av den.

> [!NOTE]
>
> Panel og verdier genereres på nytt ved hver opprettelse, så verifiser struktur fremfor et bestemt
> panel eller eksakte tall.

## Respons

Ved suksess returnerer API-et `201 Created` med den nyopprettede profilen.

**id** `string` *required*

Unik profilidentifikator (UUID).

**handle** `string`

Profilnavn eller brukernavn. Kan være `null`.

**first\_name** `string`

Fornavn. Kan være `null`.

**last\_name** `string`

Etternavn. Kan være `null`.

**email** `string`

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

**phone** `string`

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

**sex** `integer`

Biologisk kjønn etter ISO/IEC 5218 (`0` = ukjent, `1` = mann, `2` = kvinne). Kan være `null`.

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

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

**height** `number`

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

**weight** `number`

Vekt i kilogram. Kan være `null`.

**language** `string`

Foretrukket språk, en av de 32 kodene ovenfor.

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

Om denne profilen mottar transaksjonelle (programmatiske) e-poster. `null` når verdien aldri er satt.

**created\_at** `string`

ISO 8601-tidsstempel for når profilen ble opprettet.

**updated\_at** `string`

ISO 8601-tidsstempel for siste oppdatering. `null` for nyopprettede profiler.

## Feilresponser

| Status | Beskrivelse |
| - | - |
| `400` | Valideringsfeil – ett eller flere felt besto ikke valideringen. |
| `403` | Ingen tilgang – API-nøkkelen din har ikke tilgang til denne operasjonen, eller profilgruppen er utenfor tilgangskonteksten din. |
| `404` | Profilgruppen ble ikke funnet. |
| `409` | Det finnes allerede en profil for angitt `email` (svaret inneholder adressen) eller for samme person (se nedenfor), eller `Idempotency-Key` ble brukt på nytt med annet innhold, eller den opprinnelige forespørselen er ikke fullført. |
| `500` | Intern serverfeil. |

En `409` ser slik ut – tolk den som at denne profilen allerede finnes, og slå den opp med
[List opp profiler](https://docs.anivahealth.com/no/api/profiles/list-profiles.md) (`?email=`) i stedet for å prøve å opprette den på nytt:

```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, etternavn, kjønn og fødselsdato som en profil nøkkelen din har tilgang til,
får `409` med `error_name: "duplicate_profile_error"`. Bruk den returnerte `profile_id` i stedet for
å opprette 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"
}
```

Etternavnene i sandkassen som genererer testdata, er unntatt.

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