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

# Skapa profil

> Skapa en ny patientprofil och koppla den till en profilgrupp

Skapa en ny patientprofil och koppla den till en profilgrupp. Profilen innehåller demografiska uppgifter som används för bokningar och labbeställningar.

Kräver scopet `create_user`.

Skicka med en valfri `Idempotency-Key`-header så att anropet säkert kan upprepas – om samma nyckel skickas igen returneras det ursprungliga svaret i stället för att en andra bokning skapas. Se [Idempotens](https://docs.anivahealth.com/sv/concepts/idempotency.md).

## Förfrågan

### Body-parametrar

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

Patientens förnamn. Måste använda latinska tecken, mellan 1 och 100 tecken.

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

Patientens efternamn. Måste använda latinska tecken, mellan 1 och 100 tecken. Laboratorier avvisar
beställningar för en patient utan efternamn, så en profil kan inte skapas utan det.

Tre värden är reserverade för att skapa testfixturer — se [Testfixturer för sandbox](#testfixturer-foer-sandbox).

**sex** `integer` *required*

Biologiskt kön enligt ISO/IEC 5218. Använd `1` för man, `2` för kvinna. Laboratoriet behöver det för
referensintervallen, så `0` (okänt) returnerar `400`. Obligatoriskt, om inte din profilgrupp låter
patienten ange det på sidan för aktivering av kitet. Utelämna det då. Se
[Låt patienten ange födelsedatum och kön](https://docs.anivahealth.com/sv/concepts/profiles.md#lat-patienten-ange-foedelsedatum-och-koen).

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

Födelsedatum i formatet `YYYY-MM-DD`. Måste ligga i det förflutna och inte före 1900. Den beräknade åldern
måste vara mellan 16 och 100. Andra värden returnerar `400`. Obligatoriskt, om inte din profilgrupp låter
patienten ange det på sidan för aktivering av kitet. Utelämna det då.

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

Polymorfisk referens (UUID eller slug) till profilgruppen som den här profilen ska kopplas till. UUID är
den oföränderliga identifieraren och överlever namnbyten på sluggen; sluggen accepteras fortfarande för marknadsförings- och
partnerintegrationer byggda på läsbara identifierare. UUID rekommenderas. Profilgruppen måste ligga
inom din API-nyckels åtkomstkontext. Obligatoriskt om du inte skickar det utfasade
`profile_group_slug`.

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

Utfasat: använd `profile_group`. Profilgruppens slug. Bara gemener, siffror, bindestreck och
understreck.

**email** `string`

E-postadress för profilen. Om den utelämnas genererar Aniva automatiskt en e-postadress.

Om du anger `email` blir skapandet också **säkert vid nya försök**: en adress kan bara ha en profil, så
en upprepad förfrågan returnerar `409` i stället för en andra profil. Automatiskt genererade adresser är unika per
förfrågan. Skicka `email` eller en `Idempotency-Key` om din integration gör nya försök.

**phone** `string`

Telefonnummer i E.164-format (t.ex. `+14155552671`).

**height** `number`

Längd i centimeter.

**weight** `number`

Vikt i kilogram.

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

Föredraget språk för 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`. Standardvärdet är `en`.

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

Om den här profilen ska få transaktionella (automatiska) e-postmeddelanden — bokningsbekräftelser,
aviseringar om klara resultat osv. Åsidosätter profilgruppens standardinställning. Skilt från
samtycke till marknadsföring. Utelämna för att använda standardinställningen.

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

Om den här profilen samtycker till marknadsföringsmejl (nyhetsbrev, produktuppdateringar). Åsidosätter
profilgruppens standardinställning. Skilt från transaktionella e-postmeddelanden. Utelämna för att använda profilgruppens standardinställning.
Endast skrivbart: returneras inte i profilsvaret.

## Testfixturer för sandbox

Varje läsväg som är värd att testa — [Lista bokningar](https://docs.anivahealth.com/sv/api/appointments/list-appointments.md),
[Hämta resultat](https://docs.anivahealth.com/sv/api/appointments/get-results.md),
[Ladda ner dokument](https://docs.anivahealth.com/sv/api/documents/download-document.md) — är tom tills en riktig blodprovstagning sker
några dagar senare. Det gör det krångligt att skriva ett automatiserat integrationstest.

Tre värden för `last_name` är reserverade för att lösa detta. Skapa en profil med ett av dem så fyller Aniva
i förväg i tillståndet som beskrivs nedan innan svaret skickas, så att ditt nästa anrop redan ser det:

| `last_name` | Vad profilen får |
| - | - |
| `Upcomingtestmann` | En kommande `confirmed`-bokning med en kopplad panel. Inga resultat än. |
| `Partialtestmann` | En tidigare `blood_drawn`-bokning. Ungefär **hälften** av panelen är rapporterad; [Hämta resultat](https://docs.anivahealth.com/sv/api/appointments/get-results.md) är `in_progress`. |
| `Fulltestmann` | En tidigare `blood_drawn`-bokning. **Varje** biomarkör i panelen är rapporterad, `status: "completed"`, och en labbrapport som PDF i `documents[]`. |

Matchningen är skiftlägesokänslig. Alla andra fält — inklusive `date_of_birth` och `sex` — lagras och
används som vanligt, så referensintervallen du får tillbaka är de riktiga ålders- och könsspecifika för den
profil du skapade.

Bokningen görs på platsen **Aniva Test**, på en riktig bokningsbar tid minst fem dagar
från nu (eller för fem dagar sedan för tidigare tillstånd). Att skapa den lägger ingen labbeställning och bokar ingen
kurir.

> [!NOTE]
>
> Ge testprofiler en adress du kontrollerar. Anivas bokningspåminnelser styrs av
> `scheduled_at`, så det kommande testfallet skickar dem om inte profilen stängt av dem via
> `transactional_emails_enabled: false`.

Panelen väljs slumpmässigt bland dem din API-nyckel kan se, så dess `panel_id` går alltid att slå upp
mot din egen [Lista paneler](https://docs.anivahealth.com/sv/api/panels/list-panels.md). Kliniska biomarkörer får ett värde inom
biomarkörens referensintervall; gener får en slumpmässig genotyp från Anivas referensdata, med matchande varianter, klinisk betydelse och rs-id:n som följer av den.

> [!NOTE]
>
> Panel och värden genereras på nytt varje gång en profil skapas, så verifiera strukturen snarare än en specifik
> panel eller exakta siffror.

## Svar

Vid lyckat anrop returnerar API:et `201 Created` med den nyskapade profilen.

**id** `string` *required*

Unikt profil-ID (UUID).

**handle** `string`

Alias eller användarnamn. Kan vara `null`.

**first\_name** `string`

Förnamn. Kan vara `null`.

**last\_name** `string`

Efternamn. Kan vara `null`.

**email** `string`

E-postadress. Kan vara `null`.

**phone** `string`

Telefonnummer i E.164-format. Kan vara `null`.

**sex** `integer`

Biologiskt kön enligt ISO/IEC 5218 (`0` = okänt, `1` = man, `2` = kvinna). Kan vara `null`.

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

Födelsedatum i formatet `YYYY-MM-DD`. Kan vara `null`.

**height** `number`

Längd i centimeter. Kan vara `null`.

**weight** `number`

Vikt i kilogram. Kan vara `null`.

**language** `string`

Föredraget språk, en av de 32 koderna ovan.

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

Om den här profilen tar emot transaktionella (programmatiska) e-postmeddelanden. `null` om värdet aldrig angetts.

**created\_at** `string`

ISO 8601-tidsstämpel för när profilen skapades.

**updated\_at** `string`

ISO 8601-tidsstämpel för den senaste uppdateringen. `null` för nyskapade profiler.

## Felsvar

| Status | Beskrivning |
| - | - |
| `400` | Valideringsfel — ett eller flera fält klarade inte valideringen. |
| `403` | Förbjuden — din API-nyckel har inte åtkomst till den här åtgärden eller så ligger profilgruppen utanför din åtkomstkontext. |
| `404` | Profilgruppen hittades inte. |
| `409` | Det finns redan en profil för angiven `email` (svaret innehåller adressen), eller för samma person (se nedan), eller så återanvändes `Idempotency-Key` med annat innehåll, eller så har det ursprungliga anropet inte slutförts. |
| `500` | Internt serverfel. |

En `409` ser ut så här — tolka det som "den här profilen finns redan" och slå upp den med
[Lista profiler](https://docs.anivahealth.com/sv/api/profiles/list-profiles.md) (`?email=`) i stället för att försöka skapa den 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 samma förnamn, efternamn, kön och födelsedatum som en profil din nyckel kan se
får en `409` med `error_name: "duplicate_profile_error"`. Använd det returnerade `profile_id` i stället för att
skapa en andra 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"
}
```

De efternamn i sandbox som skapar testdata är undantagna.

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