# Create practitioner

Creates a new Practitioner record. A veterinary professional (veterinarian, technician, nurse).

Endpoint: POST /site/{siteId}/ahds/v1/practitioner
Version: 1.0
Security: bearer

## Security:

  - `bearer` (unknown)
    http bearer JWT

## Path parameters:

  - `siteId` (number, required)
    Site identifier

## Request fields (application/json):

  - `practitionerId` (string)
    Canonical unique identifier for the practitioner.
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `userId` (string)
    Reference to the associated user account.
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `licenseNumber` (string)
    Professional license number.
    Example: example

  - `licenseState` (string)
    State/jurisdiction of license.
    Example: https://example.com

  - `role` (object)
    Professional role (veterinarian, technician, nurse, specialist).

  - `role.code` (string, required)
    Code value
    Example: 12345

  - `role.system` (string, required)
    Code system URI
    Example: http://example.com/codesystem

  - `role.display` (string)
    Human-readable display
    Example: Example Display Name

  - `specialties` (array)
    List of specialties (surgery, dentistry, oncology).

  - `specialties.code` (string, required)
    Example: example

  - `specialties.system` (string, required)
    Example: example

  - `specialties.display` (string)
    Example: example

  - `facilityIds` (array)
    Facilities where this practitioner works.

  - `isActive` (boolean)
    Whether the practitioner is currently active.
    Example: true

  - `extensions` (object)
    Vendor- or practice-specific extensions.

## Response 201:

  - `201` (unknown)
    Practitioner created successfully

## Response 201 fields (application/json):

  - `practitionerId` (string, required)
    Canonical unique identifier for the practitioner.
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `userId` (string, required)
    Reference to the associated user account.
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `licenseNumber` (string, required)
    Professional license number.
    Example: example

  - `licenseState` (string, required)
    State/jurisdiction of license.
    Example: https://example.com

  - `role` (object, required)
    Professional role (veterinarian, technician, nurse, specialist).

  - `role.code` (string, required)
    Code value
    Example: 12345

  - `role.system` (string, required)
    Code system URI
    Example: http://example.com/codesystem

  - `role.display` (string)
    Human-readable display
    Example: Example Display Name

  - `specialties` (array, required)
    List of specialties (surgery, dentistry, oncology).

  - `specialties.code` (string, required)
    Example: example

  - `specialties.system` (string, required)
    Example: example

  - `specialties.display` (string)
    Example: example

  - `facilityIds` (array, required)
    Facilities where this practitioner works.

  - `isActive` (boolean, required)
    Whether the practitioner is currently active.
    Example: true

  - `createdAt` (string, required)
    Timestamp when the practitioner record was created.
    Example: 2025-01-01T00:00:00.000Z

  - `updatedAt` (string, required)
    Timestamp when the practitioner record was last updated.
    Example: 2025-01-01T00:00:00.000Z

  - `extensions` (object, required)
    Vendor- or practice-specific extensions.

## Response 400:

  - `400` (unknown)
    Invalid request body

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 409:

  - `409` (unknown)
    Practitioner with this ID already exists

