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

# Profiel aanmaken

> Stappenplan: maak patiëntprofielen aan en werk ze bij in de Aniva Partner API voordat je een bloedtest boekt.

Met deze handleiding maak je een patiëntprofiel aan en wijs je het toe aan je profielgroep. Profielen zijn het startpunt voor het inplannen van afspraken en het aanmaken van laborders.

**1. Je profielgroepreferentie ophalen**

Elk profiel moet worden toegewezen aan een profielgroep die bij je partneraccount hoort. Het veld `profile_group` accepteert de onveranderlijke UUID van de groep of de leesbare slug — de UUID heeft de voorkeur, omdat deze nooit verandert en behouden blijft als de slug wordt hernoemd.

Ken je je profielgroepreferentie niet, neem dan contact op met Aniva om deze op te vragen. Zonder geldige referentie kun je geen profielen aanmaken.

**2. Het profiel aanmaken**

Stuur een `POST`-verzoek naar `/api/v1/profiles` met de demografische gegevens van de patiënt.

> [!NOTE]
>
> `first_name` en `last_name` zijn beide verplicht. Ze accepteren alleen letters uit het Latijnse schrift (inclusief letters met accenten zoals ü), spaties, koppeltekens en apostrofen. Translitereer namen in andere schriften voordat je ze verstuurt.

> [!NOTE]
>
> Als je `email` weglaat, genereert Aniva automatisch een tijdelijk e-mailadres voor het profiel. Je kunt dit later bijwerken met een `PATCH`-verzoek.

> [!TIP]
>
> Het veld `language` bepaalt de taal die Aniva gebruikt bij de communicatie met de patiënt — bijvoorbeeld afspraakherinneringen en meldingen over uitslagen. Stel dit in op de voorkeurstaal van de patiënt. In [Profiel aanmaken](https://docs.anivahealth.com/nl/api/profiles/create-profile.md) staan de ondersteunde waarden. De standaardwaarde is `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();
```

Een geslaagd verzoek geeft `201 Created` terug met het nieuwe profielobject:

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

Bewaar de `id` — je hebt deze nodig om afspraken in te plannen en het profiel bij te werken.

**3. Het profiel bijwerken (optioneel)**

Gebruik `PATCH /api/v1/profiles/{id}` om profielvelden na het aanmaken bij te werken. Alle velden zijn optioneel — stuur alleen de velden mee die je wilt wijzigen.

Het volgende voorbeeld voegt een telefoonnummer en lengte toe:

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

Een geslaagd verzoek geeft `200 OK` terug met het volledige bijgewerkte profielobject.

## Foutafhandeling

| Status | Oorzaak | Oplossing |
| - | - | - |
| `400 Bad Request` | Een verplicht veld ontbreekt, een waarde valt buiten het bereik, of `date_of_birth` is ongeloofwaardig (in de toekomst, vóór 1900 of met een leeftijd buiten 16–100). | Bekijk de foutmelding in de response body voor de specifieke validatiefout en corrigeer het verzoek. |
| `403 Forbidden` | Je API-sleutel heeft geen toegang tot deze bewerking, of je hebt geen toegang tot de opgegeven profielgroep. | Neem contact op met Aniva om de rechten van je API-sleutel en toegang tot de profielgroep te controleren. |
| `404 Not Found` | De waarde van `profile_group` komt niet overeen met een profielgroep op je account (niet via UUID en niet via slug). | Controleer of de referentie klopt. Neem contact op met Aniva als je niet zeker bent van je UUID of slug. |
| `409 Conflict` | Er bestaat al een profiel voor dit `email` (`error_name: "email_exists_error"`), of een `Idempotency-Key` is opnieuw gebruikt met een andere body. | Gebruik het bestaande profiel voor dat e-mailadres, of stuur een nieuwe `Idempotency-Key`. |


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