---
title: "POST driver"
method: POST
path: "/v1/drivers"
tags: ["Drivers"]
---

# POST driver

`POST /v1/drivers`

Create a new driver.

## Request body

- DriverCreateApiParams
  - `state` 'ACTIVE' | 'INACTIVE' | 'LEAVE'
  - `startDate` string, date
  - `organizationUuid` string, uuid — If not provided the organization will be set to that of the API token
  - `gender` 'MALE' | 'FEMALE'
  - `firstName` string
  - `middleName` string
  - `lastName` string
  - `emailWork` string — A valid email address.
  - `emailPrivate` string — A valid email address.
  - `phoneNumber` PhoneNumberApiParams
    - `number` string — A valid phone number.
    - `country` string — ISO 3166-1 Alpha-2 country code
  - `mobilePhoneNumber` PhoneNumberApiParams
    - `number` string — A valid phone number.
    - `country` string — ISO 3166-1 Alpha-2 country code
  - `notificationChannel` 'EMAIL' | 'SMS'
  - `address` string
  - `zipCode` string
  - `city` string
  - `country` string — ISO 3166-1 Alpha-2 country code
  - `language` string — ISO 639-1 language code
  - `nationality` string — ISO 3166-1 Alpha-2 country code
  - `placeOfBirth` string
  - `birthDate` string, date
  - `internalId` string
  - `costCenter` string
  - `subCompany` string
  - `department` string
  - `location` string
  - `comment` string
  - `distanceToWorkplace` number
  - `employeePayment` number

## Response `200`

Successful operation.

- DriverDto
  - `uuid` string, uuid
  - `state` 'ACTIVE' | 'INACTIVE' | 'LEAVE'
  - `startDate` string, date
  - `gender` 'MALE' | 'FEMALE'
  - `firstName` string
  - `middleName` string
  - `lastName` string
  - `emailWork` string — A valid email address.
  - `emailWorkType` 'MANUAL' | 'AUTOMATIC'
  - `emailPrivate` string — A valid email address.
  - `phoneNumber` PhoneNumberDto
    - `number` string — A valid phone number.
    - `country` string — ISO 3166-1 Alpha-2 country code
  - `mobilePhoneNumber` PhoneNumberDto
    - `number` string — A valid phone number.
    - `country` string — ISO 3166-1 Alpha-2 country code
  - `notificationChannel` 'EMAIL' | 'SMS'
  - `address` string
  - `zipCode` string
  - `city` string
  - `country` string — ISO 3166-1 Alpha-2 country code
  - `language` string — ISO 639-1 Language Code
  - `nationality` string — ISO 3166-1 Alpha-2 country code
  - `placeOfBirth` string
  - `birthDate` string, date
  - `internalId` string
  - `costCenter` string
  - `subCompany` string
  - `department` string
  - `location` string
  - `comment` string
  - `distanceToWorkplace` number
  - `employeePayment` number
  - `eligibleForDriverBriefings` boolean
  - `eligibleForDriverLicenseChecks` boolean
  - `managementType` 'MANUAL' | 'AUTOMATIC'
  - `customFieldValuesByCategory` CustomFieldCategoryWithValuesDto[]
    - `uuid` string, uuid
    - `name` string
    - `position` integer
    - `customFieldValues` CustomFieldValueDto[]
      - `uuid` string, uuid
      - `textValue` string
      - `dateValue` string, date-time
      - `booleanValue` boolean
      - `integerValue` integer
      - `decimalValue` number
      - `monetaryAmountValue` MonetaryAmountDto
        - `amount` number
        - `currency` string — ISO 4217 alphabetic currency code
  - `organizationUuid` string, uuid

## Other responses

- `400` — Bad request - information on the invalid fields will be provided in the response body

---

[API](https://skmtc.net/avrios/apis/fleet-api-specifications.md) · [All operations](https://skmtc.net/avrios/apis/fleet-api-specifications/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avrios/fleet-api-specifications/revisions/78fc4b609513/schema)