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

# Profil erstellen

> Schritt-für-Schritt-Anleitung: Erstelle und aktualisiere Patientenprofile in der Aniva Partner API, bevor du einen Bluttest buchst.

Mit dieser Anleitung erstellst du ein Patientenprofil und weist es deiner Profilgruppe zu. Profile sind der Ausgangspunkt, um Termine zu vereinbaren und Laboraufträge auszulösen.

**1. Hol dir deine Profilgruppen-Referenz**

Jedes Profil muss einer Profilgruppe zugewiesen werden, die zu deinem Partnerkonto gehört. Das Feld `profile_group` akzeptiert entweder die unveränderliche UUID der Gruppe oder ihren menschenlesbaren Slug – die UUID wird bevorzugt, da sie sich nie ändert und Umbenennungen des Slugs überdauert.

Wenn du deine Profilgruppen-Referenz nicht kennst, kontaktiere Aniva, um sie zu erhalten. Ohne gültige Referenz kannst du keine Profile erstellen.

**2. Profil erstellen**

Sende eine `POST`-Anfrage an `/api/v1/profiles` mit den demografischen Daten des Patienten.

> [!NOTE]
>
> `first_name` und `last_name` sind beide erforderlich. Sie akzeptieren nur Buchstaben der lateinischen Schrift (einschließlich akzentuierter Buchstaben wie ü), Leerzeichen, Bindestriche und Apostrophe. Transliteriere Namen aus anderen Schriftsystemen, bevor du sie übermittelst.

> [!NOTE]
>
> Wenn du `email` weglässt, generiert Aniva automatisch eine Platzhalter-E-Mail-Adresse für das Profil. Du kannst sie später mit einer `PATCH`-Anfrage aktualisieren.

> [!TIP]
>
> Das Feld `language` steuert die Sprache, in der Aniva mit dem Patienten kommuniziert – zum Beispiel bei Terminerinnerungen und Ergebnisbenachrichtigungen. Setze es auf die bevorzugte Sprache des Patienten. Unter [Profil erstellen](https://docs.anivahealth.com/de/api/profiles/create-profile.md) findest du die unterstützten Werte. Standardwert ist `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();
```

Eine erfolgreiche Anfrage gibt `201 Created` mit dem neuen Profilobjekt zurück:

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

Speichere die `id` – du brauchst sie, um Termine zu vereinbaren und das Profil zu aktualisieren.

**3. Profil aktualisieren (optional)**

Verwende `PATCH /api/v1/profiles/{id}`, um nach dem Erstellen beliebige Profilfelder zu aktualisieren. Alle Felder sind optional – gib nur die Felder an, die du ändern möchtest.

Das folgende Beispiel fügt eine Telefonnummer und die Körpergröße hinzu:

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

Eine erfolgreiche Anfrage gibt `200 OK` mit dem vollständigen aktualisierten Profilobjekt zurück.

## Fehlerbehandlung

| Status | Ursache | Lösung |
| - | - | - |
| `400 Bad Request` | Ein Pflichtfeld fehlt, ein Wert liegt außerhalb des zulässigen Bereichs oder `date_of_birth` ist unplausibel (in der Zukunft, vor 1900 oder entspricht einem Alter außerhalb von 16–100). | Prüfe den Body der Fehlerantwort auf die konkrete Validierungsmeldung und korrigiere die Anfrage. |
| `403 Forbidden` | Dein API-Key hat keinen Zugriff auf diesen Vorgang oder du hast keinen Zugriff auf die angegebene Profilgruppe. | Kontaktiere Aniva, um die Berechtigungen deines API-Keys und den Zugriff auf die Profilgruppe bestätigen zu lassen. |
| `404 Not Found` | Der Wert von `profile_group` stimmt mit keiner Profilgruppe in deinem Konto überein (weder per UUID noch per Slug). | Prüfe, ob die Referenz korrekt ist. Kontaktiere Aniva, wenn du dir bei deiner UUID oder deinem Slug unsicher bist. |
| `409 Conflict` | Für diese `email` existiert bereits ein Profil (`error_name: "email_exists_error"`), oder ein `Idempotency-Key` wurde mit einem anderen Body wiederverwendet. | Verwende das bestehende Profil für diese E-Mail-Adresse oder sende einen neuen `Idempotency-Key`. |


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