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

# Create Patient

> Register a new patient in your clinic

## Body Parameters

<ParamField body="firstName" type="string" required>
  Patient's first name
</ParamField>

<ParamField body="lastName" type="string" required>
  Patient's last name
</ParamField>

<ParamField body="email" type="string">
  Email address
</ParamField>

<ParamField body="phone" type="string" required>
  Phone number with country code (e.g., `+573001234567`)
</ParamField>

<ParamField body="documentType" type="string" required>
  Document type: `CC` (Cédula), `CE` (Cédula de Extranjería), `TI` (Tarjeta de Identidad), `PA` (Pasaporte), `RC` (Registro Civil)
</ParamField>

<ParamField body="documentNumber" type="string" required>
  Document number (unique within the clinic)
</ParamField>

<ParamField body="dateOfBirth" type="string">
  Date of birth in `YYYY-MM-DD` format
</ParamField>

<ParamField body="gender" type="string">
  Patient gender: `male`, `female`, `other`
</ParamField>

<ParamField body="address" type="object">
  Patient address

  <Expandable title="address">
    <ParamField body="street" type="string">Street address</ParamField>
    <ParamField body="city" type="string">City</ParamField>
    <ParamField body="state" type="string">State/Department</ParamField>
    <ParamField body="country" type="string">ISO 3166-1 alpha-2 country code</ParamField>
    <ParamField body="postalCode" type="string">Postal code</ParamField>
  </Expandable>
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.nevatal.com/api/v1/patients" \
    -H "Authorization: Bearer nvtl_your_api_key" \
    -H "Content-Type: application/json" \
    -d '{
      "firstName": "María",
      "lastName": "García",
      "phone": "+573001234567",
      "email": "maria@example.com",
      "documentType": "CC",
      "documentNumber": "1234567890",
      "dateOfBirth": "1990-05-15",
      "gender": "female"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "id": "pat_abc123",
    "firstName": "María",
    "lastName": "García",
    "email": "maria@example.com",
    "phone": "+573001234567",
    "documentType": "CC",
    "documentNumber": "1234567890",
    "dateOfBirth": "1990-05-15",
    "gender": "female",
    "status": "active",
    "createdAt": "2025-03-15T10:30:00Z"
  }
  ```

  ```json 400 theme={null}
  {
    "statusCode": 400,
    "error": "Bad Request",
    "message": "Document number already exists in this clinic"
  }
  ```
</ResponseExample>