> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telepatia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Crear un paciente

> Copia en Cursor/Claude/Copilot para generar una integración POST /v1/patients.

Pega este prompt en tu asistente de programación con IA. Ya incluye el contrato, la autenticación y el envoltorio de errores, para que el código generado coincida con la API de producción.

<CodeGroup>
  ```text Prompt theme={null}
  Estás integrando la API pública de Telepatia Synapse.

  Endpoint: POST /v1/patients
  Base URL: https://scribe-api.telepatia.ai
  Auth: Authorization: Bearer ${SYNAPSE_API_KEY}

  Solicitud:
  - name [body]: string (requerido, minLength=1, maxLength=500)
  - idCountry [body]: string (requerido, enum: 250 values) — ISO 3166-1 alpha-2 country codes. Mirrors tanjiro's CountryCodes enum.
  - idType [body]: string (requerido, enum: 8 values) — Tipos de documento de identificación de paciente soportados.
  - idValue [body]: string (requerido, minLength=1, maxLength=50)
  - internalCode [body]: string (opcional, minLength=1, maxLength=128) — Caller-provided internal code, unique within your institution.

  Éxito 200:
  - id: string
  - name: string
  - idCountry?: string
  - idType?: string
  - idValue?: string
  - internalCode?: string
  - createdAt: string

  Errores (envoltorio: { error: { type, code, message, param? } }):
  - 400: parameter_missing, parameter_invalid, account_invalid
  - 401: authentication_required
  - 409: resource_conflict
  - 503: service_unavailable

  Genera código en el lenguaje del archivo actual que:
  1. Lea SYNAPSE_API_KEY desde el entorno (no lo escribas de forma fija).
  2. Llame al endpoint con solicitud y respuesta tipadas.
  3. Asigne el envoltorio de errores a excepciones tipadas por código de estado.
  4. Agregue una prueba de flujo exitoso usando el token Bearer.
  ```

  ```bash curl theme={null}
  curl -X POST https://scribe-api.telepatia.ai/v1/patients \
    -H "Authorization: Bearer $SYNAPSE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
    "idCountry": "COLOMBIA",
    "idType": "CC",
    "idValue": "1024567890",
    "internalCode": "EMR-12345",
    "name": "John Doe"
  }'
  ```
</CodeGroup>