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

> Steg-för-steg-guide: skapa och uppdatera patientprofiler i Aniva Partner API innan du bokar ett blodprov.

Använd den här guiden för att skapa en patientprofil och koppla den till din profilgrupp. Profiler är utgångspunkten för att skapa bokningar och starta labbeställningar.

**1. Hämta din profilgruppsreferens**

Varje profil måste kopplas till en profilgrupp som tillhör ditt partnerkonto. Fältet `profile_group` tar antingen emot gruppens oföränderliga UUID eller dess läsbara slug – UUID rekommenderas eftersom det aldrig ändras och fungerar även om slugen byter namn.

Om du inte känner till din profilgruppsreferens, kontakta Aniva för att få den. Du kan inte skapa profiler utan en giltig referens.

**2. Skapa profilen**

Skicka en `POST`-förfrågan till `/api/v1/profiles` med patientens demografiska uppgifter.

> [!NOTE]
>
> Både `first_name` och `last_name` är obligatoriska. De tar bara emot bokstäver i det latinska alfabetet (inklusive accentuerade bokstäver som ü), mellanslag, bindestreck och apostrofer. Translitterera namn i andra skriftsystem innan du skickar in dem.

> [!NOTE]
>
> Om du utelämnar `email` skapar Aniva automatiskt en tillfällig e-postadress för profilen. Du kan uppdatera den senare med en `PATCH`-förfrågan.

> [!TIP]
>
> Fältet `language` styr vilket språk Aniva använder i kommunikationen med patienten – till exempel bokningspåminnelser och aviseringar om resultat. Ställ in det så att det matchar patientens föredragna språk. [Skapa profil](https://docs.anivahealth.com/sv/api/profiles/create-profile.md) listar de värden som stöds. Standardvärdet är `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 lyckad förfrågan returnerar `201 Created` med det nya 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
}
```

Spara `id` – du behöver det för att skapa bokningar och uppdatera profilen.

**3. Uppdatera profilen (valfritt)**

Använd `PATCH /api/v1/profiles/{id}` för att uppdatera valfria profilfält efter att profilen har skapats. Alla fält är valfria – ta bara med de fält du vill ändra.

Följande exempel lägger till ett telefonnummer och längd:

```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 lyckad förfrågan returnerar `200 OK` med hela det uppdaterade profilobjektet.

## Felhantering

| Status | Orsak | Lösning |
| - | - | - |
| `400 Bad Request` | Ett obligatoriskt fält saknas, ett värde ligger utanför tillåtet intervall, eller `date_of_birth` är orimligt (i framtiden, före 1900 eller motsvarar en ålder utanför 16–100). | Kontrollera felsvaret för det specifika valideringsmeddelandet och korrigera förfrågan. |
| `403 Forbidden` | Din API-nyckel har inte behörighet till den här åtgärden, eller så har du inte åtkomst till den angivna profilgruppen. | Kontakta Aniva för att bekräfta behörigheterna för din API-nyckel och åtkomsten till profilgruppen. |
| `404 Not Found` | Värdet i `profile_group` matchar ingen profilgrupp på ditt konto (varken via UUID eller slug). | Kontrollera att referensen stämmer. Kontakta Aniva om du är osäker på ditt UUID eller din slug. |
| `409 Conflict` | Det finns redan en profil för den här `email` (`error_name: "email_exists_error"`), eller så återanvändes en `Idempotency-Key` med annat innehåll. | Använd den befintliga profilen för den e-postadressen eller skicka en ny `Idempotency-Key`. |


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