# Create Practitioner

Creates a new practitioner (doctor or veterinarian) in the system. This endpoint is used to onboard practitioners by collecting their personal, professional, and contact information.

Notes:
- All required fields must be provided and valid
- assigned_clinic must reference an existing clinic UUID
- Validation errors will return descriptive messages for each field

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

## Request fields (application/json):

  - `first_name` (string, required)
    Practitioner's first name
    Example: "Sarah"

  - `last_name` (string, required)
    Practitioner's last name
    Example: "Johnson"

  - `email` (string, required)
    Practitioner's email address
    Example: "dr.johnson@partnerclinic.com"

  - `phone` (string)
    Practitioner's phone number
    Example: "+1-555-0123"

  - `npi_number` (string, required)
    National Provider Identifier (10 digits)
    Example: "1234567890"

  - `dea_number` (string)
    DEA registration number
    Example: "FJ1234563"

  - `license_number` (string)
    State medical license number
    Example: "MD-12345"

  - `license_state` (string)
    State of licensure (2-letter code)
    Example: "CA"

  - `signature_image` (string)
    Base64 encoded signature image

  - `assigned_clinic` (string, required)
    UUID of the clinic to assign this practitioner
    Example: "550e8400-e29b-41d4-a716-446655440000"

## Response 200 fields (application/json):

  - `success` (boolean)
    Example: true

  - `data` (object)

  - `data.practitioner_id` (string)
    Unique identifier for the created practitioner
    Example: "660e8400-e29b-41d4-a716-446655440001"

  - `message` (string)
    Example: "Practitioner 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: {}