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

# Créer un profil

> Guide étape par étape : créer et mettre à jour des profils patients dans l'API partenaire Aniva avant de réserver un bilan sanguin.

Utilise ce guide pour créer un profil patient et l'attribuer à ton groupe de profils. Les profils sont le point de départ pour planifier des rendez-vous et déclencher des commandes de laboratoire.

**1. Obtenir la référence de ton groupe de profils**

Chaque profil doit être attribué à un groupe de profils qui appartient à ton compte partenaire. Le champ `profile_group` accepte soit l'UUID immuable du groupe, soit son slug lisible — l'UUID est préférable car il ne change jamais et reste valide même si le slug est renommé.

Si tu ne connais pas la référence de ton groupe de profils, contacte Aniva pour l'obtenir. Tu ne peux pas créer de profils sans référence valide.

**2. Créer le profil**

Envoie une requête `POST` à `/api/v1/profiles` avec les données démographiques du patient.

> [!NOTE]
>
> `first_name` et `last_name` sont tous deux obligatoires. Ils n'acceptent que les lettres de l'alphabet latin (y compris les lettres accentuées comme ü), les espaces, les traits d'union et les apostrophes. Translittère les noms écrits dans d'autres alphabets avant de les envoyer.

> [!NOTE]
>
> Si tu omets `email`, Aniva génère automatiquement une adresse e-mail temporaire pour le profil. Tu peux la mettre à jour plus tard avec une requête `PATCH`.

> [!TIP]
>
> Le champ `language` détermine la langue qu'Aniva utilise pour communiquer avec le patient, par exemple pour les rappels de rendez-vous et les notifications de résultats. Définis-le selon la langue préférée du patient. [Créer un profil](https://docs.anivahealth.com/fr/api/profiles/create-profile.md) liste les valeurs prises en charge. Par défaut : `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();
```

Une requête réussie renvoie `201 Created` avec le nouvel objet profil :

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

Conserve l'`id` — tu en auras besoin pour planifier des rendez-vous et mettre à jour le profil.

**3. Mettre à jour le profil (facultatif)**

Utilise `PATCH /api/v1/profiles/{id}` pour mettre à jour n'importe quel champ du profil après sa création. Tous les champs sont facultatifs — n'inclus que les champs que tu souhaites modifier.

L'exemple suivant ajoute un numéro de téléphone et une taille :

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

Une requête réussie renvoie `200 OK` avec l'objet profil complet mis à jour.

## Gestion des erreurs

| Statut | Cause | Résolution |
| - | - | - |
| `400 Bad Request` | Un champ obligatoire est manquant, une valeur est hors limites ou `date_of_birth` est invraisemblable (dans le futur, avant 1900 ou correspondant à un âge en dehors de 16–100 ans). | Consulte le corps de la réponse d'erreur pour voir le message de validation précis et corrige la requête. |
| `403 Forbidden` | Ta clé API n'a pas accès à cette opération ou tu n'as pas accès au groupe de profils indiqué. | Contacte Aniva pour confirmer les autorisations de ta clé API et ton accès au groupe de profils. |
| `404 Not Found` | La valeur de `profile_group` ne correspond à aucun groupe de profils de ton compte (ni par UUID ni par slug). | Vérifie que la référence est correcte. Contacte Aniva si tu n'es pas sûr de ton UUID ou de ton slug. |
| `409 Conflict` | Un profil existe déjà pour cet `email` (`error_name: "email_exists_error"`), ou une `Idempotency-Key` a été réutilisée avec un corps différent. | Utilise le profil existant pour cette adresse e-mail ou envoie une nouvelle `Idempotency-Key`. |


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