# Create Patient

Register a new patient in NovaMed under your partner account.

Notes:
- All required fields must be provided
- clinic_id must reference an existing clinic UUID
- Address information is required for shipping

Endpoint: POST /api/external/patient
Version: 1.0.0
Security: ApiKeyAuth

## Request fields (application/json):

  - `clinic_id` (string, required)
    UUID of the clinic
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `first_name` (string, required)
    Patient's first name
    Example: "John"

  - `last_name` (string, required)
    Patient's last name
    Example: "Smith"

  - `date_of_birth` (string, required)
    Patient's date of birth (YYYY-MM-DD)
    Example: "1985-03-15"

  - `gender` (string)
    Patient's gender
    Enum: "male", "female", "other"

  - `email` (string, required)
    Patient's email address
    Example: "john.smith@email.com"

  - `phone` (string)
    Patient's phone number
    Example: "+1-555-0199"

  - `address_line1` (string)
    Street address line 1
    Example: "123 Main Street"

  - `address_line2` (string)
    Street address line 2 (optional)
    Example: "Apt 4B"

  - `city` (string)
    City
    Example: "San Francisco"

  - `state` (string)
    State (2-letter code)
    Example: "CA"

  - `zip` (string)
    ZIP/Postal code
    Example: "94102"

## Response 200 fields (application/json):

  - `success` (boolean)
    Example: true

  - `data` (object)

  - `data.patient_id` (string)
    Unique identifier for the created patient
    Example: "770e8400-e29b-41d4-a716-446655440002"

  - `message` (string)
    Example: "Patient created successfully"

## Response 400 fields (application/json):

  - `success` (boolean)

  - `error` (object)

  - `error.message` (string)
    Human-readable error message
    Example: "Validation error"

  - `error.details` (object)
    Additional error details
    Example: {}

## Response 401 fields (application/json):

  - `success` (boolean)

  - `error` (object)

  - `error.message` (string)
    Human-readable error message
    Example: "Validation error"

  - `error.details` (object)
    Additional error details
    Example: {}