# Associate driver to vehicle

Associates an existing driver with the specified vehicle, or creates a new driver and associates them. If driverId is provided (>0), the driver must exist. If driverId is 0, firstName and lastName are required to create a new driver.

Endpoint: POST /v1/drivers/vehicles
Version: 1.0.0
Security: BearerAuth, ApiKeyAuth

## Request fields (application/json):

  - `vehicleId` (integer, required)
    Vehicle ID to associate the driver with.

  - `driver` (object, required)

  - `driver.driverId` (integer)
    Existing driver ID. Omit or use 0 to create new driver.

  - `driver.firstName` (string, required)
    Driver first name (required for new drivers).

  - `driver.middleName` (string | null)
    Driver middle name.

  - `driver.lastName` (string, required)
    Driver last name (required for new drivers).

## Response 200 fields (application/json):

  - `vehicleId` (integer)
    Vehicle ID.

  - `vin` (string | null)
    Vehicle VIN.

  - `driverId` (integer)
    Driver ID.

  - `clientName` (string | null)
    Client name.

  - `firstName` (string | null)
    Driver first name.

  - `middleName` (string | null)
    Driver middle name.

  - `lastName` (string | null)
    Driver last name.

  - `driverName` (string | null)
    Driver full name.

  - `createdDate` (string | null)
    Record created date.

  - `modifiedDate` (string | null)
    Record modified date.

  - `createdBy` (string | null)
    Created by user.

  - `modifiedBy` (string | null)
    Modified by user.

  - `message` (string | null)
    Success message.