---
title: "Create a new vehicle"
method: POST
path: "/v1/vehicles"
---

# Create a new vehicle

`POST /v1/vehicles`

## Headers

- `X-Time-Zone` string
- `X-Metric-Units` boolean
- `X-User-Id` integer

## Request body

- object
  - `number` integer, required — A unique number assigned to the vehicle that you are creating. NOTE: Ensure to add a unique number for each vehicle that you create. If you use an existing number, the system will notify that you are using an existing number.
  - `eld_device_id` integer — Specify the ID number of the vehicle gateway that is assigned to the vehicle.
  - `status` string — Specify the status of the vehicle. Allowed values are <b>active</b>, and <b>inactive</b>.
  - `ifta` boolean — Specify if the vehicle is part of the IFTA calculations. TRUE: Denotes that the vehicle is part of the calculations. FALSE: The vehicle is not part of the calculations.
  - `metric_units` boolean — Specify if the is using Metric Units or the Imperial Units. TRUE: Uses the metric units. FALSE: Uses the imperial units.
  - `fuel_type` string — Specify the type of the fuel the vehicle is using. Allowed values are: diesel, gasoline, propane, lng, cng, ethanol, methanol, e85, m85, a55, biodiesel, and other.
  - `vin` string — Specify the Vehicle Identification Number (VIN).
  - `license_plate_state` string — Specify the state where the license number was issued.
  - `license_plate_number` string — Specify the license number plate of the vehicle.
  - `make` string — Specify the make of the vehicle.
  - `model` string — Specify the model of the vehicle.
  - `year` string — Specify the year when the vehicle was manufactured.
  - `prevent_auto_odometer_entry` boolean — Specify if the vehicle prevents an auto odometer entry. TRUE: The vehicle prevents the odometer entry. FALSE: The vehicle does not prevent the odometer entry.
  - `external_ids_attributes` object[] — Specify the external ID, as well as the associated integration name for the vehicle.
    - `external_id` string, required — Denotes the external ID of the entity.
    - `integration_name` string, required — The integration with which the external_id is associated.
    - `external_id_holder_id` integer, required — The unique identifier assigned to the entity such as a user, vehicle, asset, or a group. If your entity is a user, then enter the user ID here. If a vehicle, enter the vehicle ID. Similarly for asset (asset ID), and group (group ID).
    - `external_id_holder_type` string, required — Type of the external ID holder. Allowed values are <ul><li><b>User</b></li><li><b>Vehicle</b></li><li><b>Asset</b></li><li><b>Group</b></ul>
  - `permanent_driver_id` integer — Specify the permanent driver ID that is assigned to the driver of the vehicle.
  - `notes` string — Mention any notes for the vehicle that you are creating.
  - `group_ids` object
    - integer[] — Specify the IDs of the group with which the vehicle is associated.
  - `driver_facing_camera` integer — Denotes if the recording of the driver facing camera is enabled or not. Allowed values are: -1: no_override (meaning cannot be overridden), 0: No recording, 1: Recording enabled, 2: No recording while idling, & 3: Recording enabled if engine in ON.
  - `incab_audio_recording` integer — Denotes if the audio from the driver's cab is being recorded or not. Allowed values are: -1: No manual override, 0: No recording of audio, 1: Audio recording enabled.
  - `availability_details` object
    - `availability_status` string — Denotes the availability status of the vehicle/asset. Allowed values are <ul><li><b>out_of_service</b></li> or <li><b>in_service</b></li></ul>
    - `additional_note` string — Denotes any comments or notes added for updating the availability of the vehicle/asset. For example, “This vehicle/asset is scheduled for maintenance”.
    - `custom_driver_app_warning_prompt` string — This denotes the prompt message that drivers see on their driver_app. This prompt can be used to inform the driver about the status of the vehicle/asset or communicate any specific instructions. For example, “Vehicle/Asset is under maintenance, do not operate. ”

## Response `200`

200

- object
  - `vehicle` object
    - `id` unknown
    - `company_id` integer
    - `number` string
    - `status` string
    - `ifta` boolean
    - `vin` unknown
    - `make` unknown
    - `model` unknown
    - `year` unknown
    - `license_plate_state` unknown
    - `license_plate_number` unknown
    - `metric_units` boolean
    - `fuel_type` string
    - `prevent_auto_odometer_entry` boolean
    - `notes` unknown
    - `group_ids` object[]
    - `created_at` unknown
    - `updated_at` unknown
    - `mcleod_id` unknown
    - `permanent_driver` unknown
    - `eld_device` unknown
    - `current_driver` unknown
    - `external_ids` object[]
  - `availability_details` object
    - `availability_status` string
    - `out_of_service_reason` string
    - `updated_at` string
    - `additional_note` string
    - `custom_driver_app_warning_prompt` string
    - `updated_by_user` object
      - `id` integer
      - `first_name` string
      - `last_name` string
      - `user_name` string
      - `email` string
      - `company_reference_id` integer
      - `status` string
      - `role` string

## Other responses

- `400` — 400
- `403` — 403

---

[API](https://skmtc.net/gomotive/apis/motive.md) · [All operations](https://skmtc.net/gomotive/apis/motive/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gomotive/motive/versions/c71780e497f5/schema)