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

> Guida passo passo: crea e aggiorna i profili dei pazienti nell'Aniva Partner API prima di prenotare un esame del sangue.

Usa questa guida per creare un profilo paziente e assegnarlo al tuo gruppo di profili. I profili sono il punto di partenza per prenotare appuntamenti e avviare ordini di laboratorio.

**1. Recupera il riferimento del tuo gruppo di profili**

Ogni profilo deve essere assegnato a un gruppo di profili del tuo account partner. Il campo `profile_group` accetta l'UUID immutabile del gruppo o il suo slug leggibile — l'UUID è preferibile perché non cambia mai e resta valido anche se lo slug viene rinominato.

Se non conosci il riferimento del tuo gruppo di profili, contatta Aniva per ottenerlo. Non puoi creare profili senza un riferimento valido.

**2. Crea il profilo**

Invia una richiesta `POST` a `/api/v1/profiles` con i dati anagrafici del paziente.

> [!NOTE]
>
> `first_name` e `last_name` sono entrambi obbligatori. Accettano solo lettere dell'alfabeto latino (incluse lettere accentate come ü), spazi, trattini e apostrofi. Traslittera i nomi in altri alfabeti prima di inviarli.

> [!NOTE]
>
> Se ometti `email`, Aniva genera automaticamente un indirizzo email segnaposto per il profilo. Puoi aggiornarlo in seguito con una richiesta `PATCH`.

> [!TIP]
>
> Il campo `language` controlla la lingua che Aniva usa per comunicare con il paziente, ad esempio per i promemoria degli appuntamenti e le notifiche dei risultati. Impostalo in base alla lingua preferita del paziente. [Crea profilo](https://docs.anivahealth.com/it/api/profiles/create-profile.md) elenca i valori supportati. Il valore predefinito è `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 richiesta riuscita restituisce `201 Created` con il nuovo oggetto profilo:

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

Salva l'`id` — ti servirà per prenotare appuntamenti e aggiornare il profilo.

**3. Aggiorna il profilo (facoltativo)**

Usa `PATCH /api/v1/profiles/{id}` per aggiornare qualsiasi campo del profilo dopo la creazione. Tutti i campi sono facoltativi — includi solo i campi che vuoi modificare.

L'esempio seguente aggiunge un numero di telefono e l'altezza:

```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 richiesta riuscita restituisce `200 OK` con l'oggetto profilo aggiornato completo.

## Gestione degli errori

| Stato | Causa | Risoluzione |
| - | - | - |
| `400 Bad Request` | Manca un campo obbligatorio, un valore è fuori intervallo oppure `date_of_birth` non è plausibile (nel futuro, precedente al 1900 o corrispondente a un'età fuori dall'intervallo 16–100). | Controlla il corpo della risposta di errore per il messaggio di validazione specifico e correggi la richiesta. |
| `403 Forbidden` | La tua chiave API non ha accesso a questa operazione o non hai accesso al gruppo di profili specificato. | Contatta Aniva per confermare i permessi della tua chiave API e l'accesso al gruppo di profili. |
| `404 Not Found` | Il valore di `profile_group` non corrisponde a nessun gruppo di profili del tuo account (né per UUID né per slug). | Verifica che il riferimento sia corretto. Contatta Aniva se non conosci con certezza il tuo UUID o slug. |
| `409 Conflict` | Esiste già un profilo per questa `email` (`error_name: "email_exists_error"`), oppure un `Idempotency-Key` è stato riutilizzato con un corpo diverso. | Usa il profilo esistente per quella email oppure invia un nuovo `Idempotency-Key`. |


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