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

# Crear un perfil

> Guía paso a paso: crea y actualiza perfiles de pacientes en la API para partners de Aniva antes de reservar un análisis de sangre.

Usa esta guía para crear un perfil de paciente y asignarlo a tu grupo de perfiles. Los perfiles son el punto de partida para programar citas y activar pedidos de laboratorio.

**1. Obtener la referencia de tu grupo de perfiles**

Cada perfil debe asignarse a un grupo de perfiles que pertenezca a tu cuenta de socio. El campo `profile_group` acepta el UUID inmutable del grupo o su slug legible; se recomienda usar el UUID porque nunca cambia y sobrevive a los cambios de nombre del slug.

Si no conoces la referencia de tu grupo de perfiles, contacta con Aniva para obtenerla. No puedes crear perfiles sin una referencia válida.

**2. Crear el perfil**

Envía una solicitud `POST` a `/api/v1/profiles` con los datos demográficos del paciente.

> [!NOTE]
>
> Tanto `first_name` como `last_name` son obligatorios. Solo aceptan letras del alfabeto latino (incluidas letras con signos diacríticos, como ü), espacios, guiones y apóstrofos. Translitera los nombres en otros alfabetos antes de enviarlos.

> [!NOTE]
>
> Si omites `email`, Aniva genera automáticamente una dirección de correo electrónico provisional para el perfil. Puedes actualizarla más adelante con una solicitud `PATCH`.

> [!TIP]
>
> El campo `language` controla el idioma que usa Aniva al comunicarse con el paciente; por ejemplo, recordatorios de citas y notificaciones de resultados. Configúralo para que coincida con el idioma preferido del paciente. En [Crear perfil](https://docs.anivahealth.com/es/api/profiles/create-profile.md) se indican los valores admitidos. El valor predeterminado es `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 solicitud correcta devuelve `201 Created` con el nuevo objeto 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
}
```

Guarda el `id`: lo necesitarás para programar citas y actualizar el perfil.

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

Usa `PATCH /api/v1/profiles/{id}` para actualizar cualquier campo del perfil después de crearlo. Todos los campos son opcionales: incluye solo los que quieras cambiar.

El siguiente ejemplo añade un número de teléfono y la altura:

```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 solicitud correcta devuelve `200 OK` con el objeto de perfil completo actualizado.

## Gestión de errores

| Estado | Causa | Solución |
| - | - | - |
| `400 Bad Request` | Falta un campo obligatorio, un valor está fuera de rango o `date_of_birth` no es plausible (en el futuro, anterior a 1900 o implica una edad fuera del rango de 16 a 100 años). | Consulta el cuerpo de la respuesta de error para ver el mensaje de validación específico y corrige la solicitud. |
| `403 Forbidden` | Tu clave de API no tiene acceso a esta operación o no tienes acceso al grupo de perfiles especificado. | Contacta con Aniva para confirmar los permisos de tu clave de API y el acceso al grupo de perfiles. |
| `404 Not Found` | El valor de `profile_group` no coincide con ningún grupo de perfiles de tu cuenta (ni por UUID ni por slug). | Comprueba que la referencia sea correcta. Contacta con Aniva si no estás seguro de tu UUID o slug. |
| `409 Conflict` | Ya existe un perfil para este `email` (`error_name: "email_exists_error"`), o se ha reutilizado una `Idempotency-Key` con un cuerpo distinto. | Usa el perfil existente para ese correo electrónico o envía una nueva `Idempotency-Key`. |


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