Skip to main content
POST
/
v2
/
vehicles
/
Create
curl --request POST \
  --url https://api.app.fleetit.com/v2/vehicles/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "plate_state": "CA",
  "plate_number": "ABC123",
  "vehicle_make": "Toyota",
  "vehicle_model": "Camry",
  "year": "2022",
  "active": false,
  "lessee_renter": null,
  "vehicle_number": "325",
  "custom_fields": {
    "Location": "test",
    "Equipment Number": "",
    "Trial_added": "",
    "Tracking": ""
  },
  "vehicle_type_code": "520_520"
}'
{
  "status": "success",
  "message": "Vehicle created successfully.",
  "data": {
    "vehicle_id": "123456",
    "plate_number": "XYZ789",
    "plate_state": "TX",
    "vehicle_number": "789",
    "vehicle_make": "Honda",
    "vehicle_model": "Civic",
    "year": "2020",
    "lessee_renter": "John Doe",
    "custom_fields": {
      "Location": "test",
      "Equipment Number": "",
      "Trial_added": "",
      "Tracking": ""
    },
    "vehicle_type_code": "SEDAN",
    "added_date": "2024-12-27T08:58:26.068690-05:00",
    "active": true
  }
}
Custom fields are set at the fleet level by FleetIT. You can include custom field values when creating a vehicle, but you cannot create new custom field names. The system will only accept custom fields that are predefined for your fleet.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Fleet-Id
string

Body

application/json
​
plate_state
string
required

Required. Two-letter state code (A-Z only, exactly 2 characters). Auto-formatted to uppercase. Defaults to 'NY' if not provided.

Required string length: 2
Example:

"CA"

​
plate_number
string
required

Required. License plate number (max 15 characters, letters and numbers only). Auto-formatted to uppercase with special characters removed. Must be unique when combined with plate_state.

Required string length: 1 - 15
Example:

"ABC123"

​
vehicle_make
string

Vehicle manufacturer name.

Example:

"Toyota"

​
vehicle_model
string

Vehicle model name.

Example:

"Camry"

​
year
string

Manufacturing year (1000 to current year + 100). Numeric digits only, auto-extracted from mixed input.

Example:

"2022"

​
active
boolean

Vehicle status. Defaults to true if not specified.

Example:

false

​
lessee_renter
string

Name of the person or entity leasing/renting the vehicle.

Example:

null

​
vehicle_number
string

VIN or custom vehicle identifier (max 20 characters, any format allowed). Not required and uniqueness not enforced.

Maximum length: 20
Example:

"325"

​
custom_fields
object

Custom fields for the vehicle. Custom fields are set at the fleet level by FleetIT. You can only update the values, not the field names.

Example:
{
  "Location": "test",
  "Equipment Number": "",
  "Trial_added": "",
  "Tracking": ""
}
​
vehicle_type_code
string

Vehicle type code for classification.

Example:

"520_520"

Response

200 - application/json

Successful response

​
status
string
Example:

"success"

​
message
string
Example:

"Vehicle created successfully."

​
data
object