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

# Crea un perfil

> Guia pas a pas: crea i actualitza perfils de pacients a l'API per a col·laboradors d'Aniva abans de reservar una anàlisi de sang.

Fes servir aquesta guia per crear un perfil de pacient i assignar-lo al teu grup de perfils. Els perfils són el punt de partida per programar cites i activar ordres de laboratori.

**1. Obtén la referència del teu grup de perfils**

Cada perfil s'ha d'assignar a un grup de perfils que pertanyi al teu compte de col·laborador. El camp `profile_group` accepta tant l'UUID immutable del grup com el seu slug llegible — l'UUID és preferible perquè no canvia mai i es manté si canvia el nom del slug.

Si no saps la referència del teu grup de perfils, contacta amb Aniva per obtenir-la. No pots crear perfils sense una referència vàlida.

**2. Crea el perfil**

Envia una petició `POST` a `/api/v1/profiles` amb les dades demogràfiques del pacient.

> [!NOTE]
>
> Tant `first_name` com `last_name` són obligatoris. Només accepten lletres de l'alfabet llatí (incloses les lletres accentuades com ara ü), espais, guions i apòstrofs. Translitera els noms escrits en altres alfabets abans d'enviar-los.

> [!NOTE]
>
> Si omets `email`, Aniva genera automàticament una adreça electrònica provisional per al perfil. Pots actualitzar-la més endavant amb una petició `PATCH`.

> [!TIP]
>
> El camp `language` controla l'idioma que Aniva fa servir quan es comunica amb el pacient, per exemple, en recordatoris de cites i notificacions de resultats. Configura'l perquè coincideixi amb l'idioma preferit del pacient. [Crea un perfil](https://docs.anivahealth.com/ca/api/profiles/create-profile.md) llista els valors admesos. El valor per defecte és `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();
```

Una petició correcta retorna `201 Created` amb el nou objecte de perfil:

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

Desa l'`id` — el necessitaràs per programar cites i actualitzar el perfil.

**3. Actualitza el perfil (opcional)**

Fes servir `PATCH /api/v1/profiles/{id}` per actualitzar qualsevol camp del perfil després de crear-lo. Tots els camps són opcionals — inclou només els camps que vulguis canviar.

L'exemple següent afegeix un número de telèfon i l'alçada:

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

Una petició correcta retorna `200 OK` amb l'objecte de perfil complet actualitzat.

## Gestió d'errors

| Estat | Causa | Solució |
| - | - | - |
| `400 Bad Request` | Falta un camp obligatori, un valor està fora de rang o `date_of_birth` no és plausible (és al futur, anterior al 1900 o implica una edat fora del rang 16–100). | Consulta el cos de la resposta d'error per veure el missatge de validació específic i corregeix la petició. |
| `403 Forbidden` | La teva clau API no té accés a aquesta operació o no tens accés al grup de perfils especificat. | Contacta amb Aniva per confirmar els permisos de la teva clau API i l'accés al grup de perfils. |
| `404 Not Found` | El valor de `profile_group` no coincideix amb cap grup de perfils del teu compte (ni per UUID ni per slug). | Comprova que la referència sigui correcta. Contacta amb Aniva si tens dubtes sobre el teu UUID o slug. |
| `409 Conflict` | Ja existeix un perfil per a aquest `email` (`error_name: "email_exists_error"`), o s'ha reutilitzat una `Idempotency-Key` amb un cos diferent. | Fes servir el perfil existent per a aquesta adreça electrònica o envia una `Idempotency-Key` nova. |


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