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"
}'
{
  "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": {},
    "vehicle_type_code": "SEDAN",
    "added_date": "2024-12-27T08:58:26.068690-05:00",
    "active": true
  }
}
Ensure that the custom fields are already attached to the fleet before adding a vehicle via payload. The system will only accept custom fields that are predefined. Currently, the only way to add custom fields is through the app interface.

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"

Response

200 - application/json

Successful response

​
status
string
Example:

"success"

​
message
string
Example:

"Vehicle created successfully."

​
data
object
⌘I