Skip to main content

Create Vehicle

Create a new Vehicle. If you need to create many Vehicles at once, use the Bulk API to avoid Rate Limiting errors.

Request Body

  • color string

    Possible values: <= 255 characters

    The color of this Vehicle.

  • fuel_type_id integer

    The ID of the Fuel Type associated with this Vehicle.

  • fuel_volume_units VolumeUnit required

    Possible values: [us_gallons, uk_gallons, liters]

  • group_id integer

    Possible values: >= 1

  • group_hierarchy string

    A pipe delimited group hierarchy. Ex: "Level 1|Level 2|Level 3". Where Level 1 is the parent of Level 2, and 2 is the parent of 3. Any missing nodes in the hierarchy will be created.

  • label_ids integer[]

    Possible values: >= 1

    The label_id(s) of any Labels to assign to this Vehicle. If you wish to keep any existing Labels, those IDs must be included in this array as well.

  • license_plate string

    Possible values: <= 255 characters

    The license plate number of this Vehicle.

  • make string

    Possible values: <= 255 characters

    The name of this Vehicle's manufacturer.

  • meter_unit MeterUnit required

    Possible values: [km, hr, mi]

    The measurement unit used for the Vehicle's primary, or secondary (if applicable), meter.

  • model string

    Possible values: <= 255 characters

    The name of the model of this Vehicle.

  • name string required

    Possible values: <= 255 characters

    A name to assign to this Vehicle. Must be unique.

  • ownership VehicleOwnership required

    Possible values: [owned, leased, rented, customer]

  • registration_expiration_month integer

    Possible values: <= 12

    The month in which this Vehicle's registration expires.

  • registration_state string

    Possible values: <= 255 characters

    The state, province, or territory in which this Vehicle is registered.

  • secondary_meter boolean

    Indicates whether or not this Vehicle has a secondary meter.

  • secondary_meter_unit MeterUnit

    Possible values: [km, hr, mi]

    The measurement unit used for the Vehicle's primary, or secondary (if applicable), meter.

  • system_of_measurement MeasurementSystem required

    Possible values: [imperial, metric]

  • trim string

    Possible values: <= 255 characters

    The trim level of this Vehicle.

  • vehicle_status_id integer required

    Possible values: >= 1

  • vehicle_type_id integer required

    Possible values: >= 1

  • vin string

    Possible values: <= 17 characters

    The Vehicle Identification Number of this Vehicle. Must be unique.

  • year integer

    This Vehicle's model year.

  • linked_vehicle_ids integer[]

    Possible values: >= 1

    The vehicle_id(s) of any Vehicles to link to this Vehicle.

  • purchase_detail_attributes object
  • comment string

    A comment about this Vehicle's purchase.

  • date date-time

    The date and time at which this Vehicle was purchased. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • price float

    The price of this Vehicle at the time of purchase.

  • vendor_id integer

    Possible values: >= 1

  • warranty_expiration_date date-time

    The date and time at which this Vehicle's warranty expires. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • warranty_expiration_meter_value float

    The meter value at which this Vehicle's warranty expires. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • meter_entry_attributes.value float

    The meter value at the time of purchase.

  • meter_entry_attributes.void boolean

    Indicates whether the Meter Entry created by passing meter_entry_attributes.value should be considered void. Voiding Meter Entries

  • external_ids object

    Any External IDs associated with this Vehicle.

  • vehicle_status_name string

    Possible values: <= 255 characters

    The name of the Vehicle Status associated with this Vehicle.

  • vehicle_type_name string

    Possible values: <= 255 characters

    The name of the Vehicle Type associated with this Vehicle.

  • in_service_date date-time

    The date on which this Vehicle was put into service. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • in_service_meter float

    The meter value at which this Vehicle was put into service.

  • estimated_service_months integer

    The estimated number of months this Vehicle will be in service.

  • estimated_replacement_mileage float

    The estimated number of miles before which this Vehicle will be replaced.

  • estimated_resale_price float

    The estimated resale price of this Vehicle.

  • out_of_service_date date-time

    The date on which this Vehicle was or will be retired. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • out_of_service_meter float

    The meter value at which this Vehicle was or will be retired.

  • specs_attributes object
  • base_towing_capacity float

    The base towing capacity of the Vehicle.

  • bed_length float

    The length of the Vehicle's bed.

  • body_subtype string

    The subtype of the Vehicle body.

  • body_type string

    The body type of the Vehicle.

  • brake_system string

    Possible values: <= 255 characters

    The brake system used in the Vehicle.

  • cargo_volume float

    Cargo volume of the Vehicle.

  • curb_weight float

    The curb weight of the Vehicle.

  • drive_type string

    Possible values: <= 255 characters

    The drive type of the Vehicle.

  • engine_aspiration string

    Possible values: <= 255 characters

    Aspiration type of the engine.

  • engine_block_type string

    Possible values: <= 255 characters

    Block type of the engine.

  • engine_bore float

    Bore size of the engine.

  • engine_brand string

    Possible values: <= 255 characters

    Brand of the Vehicle's engine.

  • engine_cam_type string

    Possible values: <= 255 characters

    Camshaft type of the engine.

  • engine_compression float

    Compression ratio of the engine.

  • engine_cylinders integer

    Number of engine cylinders.

  • engine_description string

    Description of the Vehicle's engine.

  • engine_displacement float

    The displacement of the Vehicle's engine.

  • engine_stroke float

    Stroke length of the engine.

  • engine_valves integer

    Number of engine valves.

  • epa_city float

    The EPA city fuel economy rating.

  • epa_combined float

    The combined EPA fuel economy rating.

  • epa_highway float

    The EPA highway fuel economy rating.

  • front_tire_psi float

    The recommended PSI for front tires.

  • front_tire_type string

    Possible values: <= 255 characters

    The type of front tires used in the Vehicle.

  • front_track_width float

    The front track width of the Vehicle.

  • front_wheel_diameter string

    Possible values: <= 255 characters

    The diameter of the front wheels.

  • fuel_induction string

    Possible values: <= 255 characters

    Fuel induction method.

  • fuel_quality string

    Possible values: <= 255 characters

    Fuel quality required for the engine.

  • fuel_tank_capacity float

    The fuel tank capacity of the Vehicle.

  • fuel_tank_2_capacity float

    The capacity of a second fuel tank, if applicable.

  • gross_vehicle_weight_rating float

    The Gross Vehicle Weight Rating (GVWR).

  • ground_clearance float

    The ground clearance of the Vehicle.

  • height float

    The height of the Vehicle.

  • interior_volume float

    Interior volume of the Vehicle.

  • length float

    The length of the Vehicle.

  • max_hp integer

    Maximum horsepower produced by the engine.

  • max_payload float

    The maximum payload capacity of the Vehicle.

  • max_torque integer

    Maximum torque produced by the engine.

  • msrp float

    Manufacturer's Suggested Retail Price (MSRP).

  • oil_capacity float

    Oil capacity of the engine.

  • passenger_volume string

    Possible values: <= 255 characters

    Passenger volume of the Vehicle.

  • rear_axle_type string

    Possible values: <= 255 characters

    The type of rear axle used in the Vehicle.

  • rear_tire_psi float

    The recommended PSI for rear tires.

  • rear_tire_type string

    Possible values: <= 255 characters

    The type of rear tires used in the Vehicle.

  • rear_track_width float

    The rear track width of the Vehicle.

  • rear_wheel_diameter string

    Possible values: <= 255 characters

    The diameter of the rear wheels.

  • redline_rpm string

    Possible values: <= 255 characters

    Redline RPM of the engine.

  • transmission_brand string

    Possible values: <= 255 characters

    Brand of the Vehicle's transmission.

  • transmission_description string

    Possible values: <= 255 characters

    Description of the Vehicle's transmission.

  • transmission_gears integer

    Number of gears in the transmission.

  • transmission_type string

    Possible values: <= 255 characters

    Type of transmission.

  • wheelbase float

    The wheelbase of the Vehicle.

  • width float

    The width of the Vehicle.

  • custom_fields object

    *Full details on working with Custom Fields here.

Responses

OK

Response Headers


    Schema

    • id integer
    • created_at date-time
    • updated_at date-time
    • account_id integer

      Possible values: >= 1

    • archived_at date-time

      The date and time at which the Vehicle was archived.

    • fuel_type_id NullableId

      Possible values: >= 1

    • fuel_type_name string

      The name of the Fuel Type associated with this Vehicle.

    • fuel_volume_units VolumeUnit

      Possible values: [us_gallons, uk_gallons, liters]

    • group_id NullableId

      Possible values: >= 1

    • group_name string

      The name of the Group associated with this Vehicle.

    • meter_unit MeterUnit

      Possible values: [km, hr, mi]

      The measurement unit used for the Vehicle's primary, or secondary (if applicable), meter.

    • name string

      This Vehicle's name.

    • ownership VehicleOwnershipResponse

      Possible values: [Owned, Leased, Rented, Customer]

    • secondary_meter boolean

      Indicates whether or not this Vehicle has a secondary meter.

    • secondary_meter_unit MeterUnit

      Possible values: [km, hr, mi]

      The measurement unit used for the Vehicle's primary, or secondary (if applicable), meter.

    • system_of_measurement MeasurementSystem

      Possible values: [imperial, metric]

    • labels object[]

      The Labels associated with this Vehicle. Available by passing the expand=labels query parameter.

    • id integer

      Possible values: >= 1

    • name string

      The name of the Label. This is the value used to tag a record.

    • color string

      The hex color of the Label.

    • vehicle_status_id integer

      Possible values: >= 1

    • vehicle_status_name string

      The name of the Vehicle Status associated with this Vehicle.

    • vehicle_status_color string

      The color of the Vehicle Status associated with this Vehicle.

    • vehicle_type_id integer

      Possible values: >= 1

    • vehicle_type_name string

      The name of the Vehicle Type associated with this Vehicle.

    • fuel_entries_count integer

      The number of Fuel Entries associated with this Vehicle.

    • service_entries_count integer

      The number of Service Entries associated with this Vehicle.

    • service_reminders_count integer

      The number of Service Reminders associated with this Vehicle.

    • vehicle_renewal_reminders_count integer

      The number of Vehicle Renewal Reminders associated with this Vehicle.

    • comments_count integer

      The number of Comments associated with this Vehicle.

    • documents_count integer

      The number of documents attached to this Vehicle.

    • images_count integer

      The number of images attached to this Vehicle.

    • current_location_entry_id NullableId

      Possible values: >= 1

    • is_sample boolean

      Indicates whether this Vehicle record is Sample Data.

    • in_service_date date-time

      The date on which this Vehicle was put into service.

    • in_service_meter float

      The meter value at which this Vehicle was put into service.

    • estimated_service_months integer

      The estimated number of months this Vehicle will be in service.

    • estimated_replacement_mileage string

      The estimated number of miles before which this Vehicle will be replaced.

    • estimated_resale_price object

      The estimated resale price of this Vehicle.

    • cents integer

      The estimated resale price of this Vehicle in cents.

    • currency_iso string

      The ISO 4217 currency code of the estimated resale price.

    • out_of_service_date date-time

      The date on which this Vehicle was or will be retired.

    • out_of_service_meter float

      The meter value at which this Vehicle was or will be retired.

    • meter_name string

      The name of the primary meter for this Vehicle.

    • secondary_meter_name string

      The name of the secondary meter for this Vehicle.

    • primary_meter_usage_per_day string

      The average number of units of the primary meter used per day.

    • secondary_meter_usage_per_day string

      The average number of units of the secondary meter used per day.

    • current_meter_value float

      The current value of the primary meter for this Vehicle.

    • current_meter_date date-time

      The date and time at which the primary meter was last updated.

    • secondary_meter_value float

      The current value of the secondary meter for this Vehicle.

    • secondary_meter_date date-time

      The date and time at which the secondary meter was last updated.

    • group_ancestry string

      The ancestry of the Group associated with this Vehicle.

    • color string

      The color of this Vehicle.

    • license_plate string

      The license plate number of this Vehicle.

    • vin string

      The Vehicle Identification Number of this Vehicle.

    • year string

      This Vehicle's model year.

    • make string

      The name of this Vehicle's manufacturer.

    • model string

      The name of the model of this Vehicle.

    • trim string

      The trim level of this Vehicle.

    • registration_expiration_month integer

      Possible values: <= 12

      The month in which this Vehicle's registration expires.

    • registration_state string

      The state, province, or territory in which this Vehicle is registered.

    • loan_account_number string

      The account number for this Vehicle's loan, if applicable.

    • loan_ended_at date-time

      The date and time at which this Vehicle's loan ends.

    • loan_interest_rate float

      The interest rate for this Vehicle's loan.

    • loan_notes string

      Notes about this Vehicle's loan.

    • loan_started_at date-time

      The date and time at which this Vehicle's loan began. Formatted according to ISO-8601 in User's local time.

    • loan_vendor_id NullableId

      Possible values: >= 1

    • loan_vendor_name string

      The name of the Vendor for this Vehicle's loan.

    • custom_fields object

      *Full details on working with Custom Fields here.

    • inspection_schedules_count integer

      The number of inspection schedules this Vehicle is associated with.

    • issues_count integer

      The number of Issues this Vehicle is associated with.

    • work_orders_count integer

      The number of Work Orders this Vehicle is associated with.

    • type_name string

      The name of the Vehicle Type associated with this Vehicle.

    • default_image_url string

      The URL of the default image for this Vehicle.

    • default_image_url_medium string

      The URL of a medium-sized version of the default image for this Vehicle.

    • default_image_url_small string

      The URL of a small-sized version of the default image for this Vehicle.

    • default_image_url_large string

      The URL of a large-sized version of the default image for this Vehicle.

    • specs object
    • id integer

      Possible values: >= 1

    • vehicle_id integer

      The Vehicle ID these specs belong to.

    • account_id integer
    • body_type string

      The body type of the Vehicle, if available.

    • body_subtype string

      The subtype of the Vehicle body, if available.

    • drive_type string

      The drive type of the Vehicle, if available.

    • brake_system string

      The brake system used in the Vehicle, if available.

    • msrp_cents integer

      The Manufacturer's Suggested Retail Price (MSRP) in cents, if available.

    • fuel_tank_capacity float

      The fuel tank capacity of the Vehicle, if available.

    • fuel_tank_2_capacity float

      The capacity of a second fuel tank, if available.

    • front_track_width float

      The front track width of the Vehicle, if available.

    • ground_clearance float

      The ground clearance of the Vehicle, if available.

    • height float

      The height of the Vehicle, if available.

    • length float

      The length of the Vehicle, if available.

    • rear_track_width float

      The rear track width of the Vehicle, if available.

    • width float

      The width of the Vehicle, if available.

    • wheelbase float

      The wheelbase of the Vehicle, if available.

    • front_tire_psi string

      The recommended PSI for front tires, if available.

    • rear_tire_psi string

      The recommended PSI for rear tires, if available.

    • base_towing_capacity string

      The base towing capacity of the Vehicle, if available.

    • curb_weight float

      The curb weight of the Vehicle, if available.

    • gross_vehicle_weight_rating float

      The Gross Vehicle Weight Rating (GVWR), if available.

    • bed_length string

      The length of the Vehicle's bed, if available.

    • max_payload string

      The maximum payload capacity of the Vehicle, if available.

    • rear_axle_type string

      The type of rear axle used in the Vehicle.

    • front_tire_type string

      The type of front tires used in the Vehicle.

    • front_wheel_diameter string

      The diameter of the front wheels.

    • rear_tire_type string

      The type of rear tires used in the Vehicle.

    • rear_wheel_diameter string

      The diameter of the rear wheels.

    • epa_city float

      The EPA city fuel economy rating, if available.

    • epa_highway float

      The EPA highway fuel economy rating, if available.

    • epa_combined float

      The combined EPA fuel economy rating, if available.

    • engine_description string

      Description of the Vehicle's engine.

    • engine_brand string

      Brand of the Vehicle's engine.

    • engine_aspiration string

      Aspiration type of the engine, if available.

    • engine_block_type string

      Block type of the engine, if available.

    • engine_bore string

      Bore size of the engine, if available.

    • engine_cam_type string

      Camshaft type of the engine, if available.

    • engine_compression string

      Compression ratio of the engine, if available.

    • engine_cylinders integer

      Number of engine cylinders, if available.

    • engine_displacement string

      Engine displacement, if available.

    • fuel_induction string

      Fuel induction method, if available.

    • fuel_quality string

      Fuel quality required for the engine.

    • max_hp string

      Maximum horsepower produced by the engine, if available.

    • max_torque string

      Maximum torque produced by the engine, if available.

    • oil_capacity string

      Oil capacity of the engine, if available.

    • redline_rpm string

      Redline RPM of the engine.

    • engine_stroke string

      Stroke length of the engine, if available.

    • engine_valves integer

      Number of engine valves, if available.

    • transmission_description string

      Description of the Vehicle's transmission.

    • transmission_brand string

      Brand of the Vehicle's transmission.

    • transmission_type string

      Type of transmission, if available.

    • transmission_gears integer

      Number of gears in the transmission, if available.

    • cargo_volume float

      Cargo volume of the Vehicle, if available.

    • interior_volume float

      Interior volume of the Vehicle, if available.

    • passenger_volume string

      Passenger volume of the Vehicle.

    • created_at date-time

      The date and time when the specs were created.

    • updated_at date-time

      The date and time when the specs were last updated.

    • duty_type string

      Type of duty the Vehicle is designed for, if available.

    • weight_class string

      Weight class of the Vehicle, if available.

    • engine_bore_with_units string

      Bore size of the engine with units, if available.

    • wheelbase_with_units string

      Wheelbase of the Vehicle with units, if available.

    • msrp string

      Manufacturer's Suggested Retail Price (MSRP).

    • external_ids object

      Any External IDs associated with this Vehicle.

    • ai_enabled boolean

      Whether this Vehicle has Auto Integrate enabled for it.

    • assetable_type string

      Possible values: [Vehicle]

      Assetable type for Vehicle is always Vehicle for vehicles.

    • driver object
    • id NullableId

      Possible values: >= 1

    • first_name string

      The first name of the Contact (driver) associated with this Vehicle.

    • last_name string

      The last name of the Contact (driver) associated with this Vehicle.

    • full_name string

      The full name of the Contact (driver) associated with this Vehicle.

    • default_image_url string

      The URL of the default image of the Contact (driver) associated with this Vehicle.

    • current_location_entry object

      The current location of the associated object.

    • id integer

      The unique identifier for the current Location Entry.

    • locatable_type string

      The type of object that this Location Entry is associated with.

    • locatable_id integer

      The unique identifier of the object that this Location Entry is associated with.

    • date date-time

      The date and time when this Location Entry was recorded.

    • created_at date-time

      The date and time when this Location Entry was created.

    • updated_at date-time

      The date and time when this Location Entry was last updated.

    • contact_id integer

      The unique identifier of the associated Contact.

    • address string

      The address associated with this Location Entry.

    • is_current boolean

      Indicates whether this Location Entry is the current location.

    • item_type string

      The type of item associated with this Location Entry.

    • item_id integer

      The unique identifier of the item associated with this Location Entry.

    • location string

      The geographical location in the format "POINT (longitude latitude)".

    • address_components object
    • street_number string

      The street number in the address.

    • street string

      The street name in the address.

    • city string

      The city in the address.

    • region string

      The region, state or province in the address.

    • region_short string

      The abbreviated region, state or province code.

    • country string

      The country in the address.

    • country_short string

      The abbreviated country code.

    • postal_code string

      The postal code, ZIP, or equivalent in the address.

    • geolocation object
    • latitude float

      The latitude coordinate of the location.

    • longitude float

      The longitude coordinate of the location.

    • loan_amount float

      The amount of this Vehicle's loan.

    • loan_payment float

      The amount of this Vehicle's loan payment.

    • warranties_active_count integer

      The number of active warranties associated with this Vehicle.

    • warranties_count integer

      The number of warranties associated with this Vehicle.

    • residual_value float

      The residual value of this Vehicle at the end of its lease.

    • axle_config_id integer

      The id of the Axle Configuration of this vehicle.

    Loading...