Skip to main content

Data Requirements

Inbound Syndication with HeyAuto requires specific data requirements to be present in your inventory. These data requirements are categorized as either Required or Recommended. Understanding the distinction between these categories is crucial for successful integration. Please review the data requirements carefully before syndicating your inventory.

AttributesRequiredDescription
vinRequiredThe vehicle identification number.
makeRequiredThe vehicles make, validated against acceptable vehicle makes.
modelRequiredThe vehicles model.
yearRequiredThe vehicles year.
conditionRequiredThe condition of the vehicle, "new" for new vehicles and "used" for used vehicles.
priceRecommendedThe vehicles price in CAD.
sale_priceRecommendedThe vehicles sale price in CAD. This is the full price of the vehicle on sale; if present, it will be used instead of the price.
msrpRecommendedThe vehicles Manufacturer Suggested Retail Price (MSRP) in CAD.
dealer_costRecommendedThe vehicles Cost to Acquire in CAD.
dealer_idRecommended/RequiredA unique identifier used to distinguish the dealership to which the vehicle belongs. Required if the inventory file contains data for multiple dealerships; recommended for single-dealership data.
stock_numberRecommendedThe vehicles stock number, an internal identifier for the dealership.
trimRecommendedThe vehicles trim, validated against acceptable trims. Values not recognized as trims will be removed from the vehicle in HeyAutos system.
descriptionRecommendedThe vehicles description, as provided by the dealership, subject to validation and moderation.
mileageRecommendedThe vehicles mileage in kilometers.
bodyRecommendedThe vehicles body type.
exterior_colorRecommendedThe vehicles exterior color.
interior_colorRecommendedThe vehicles interior color.
transmissionRecommendedThe vehicles transmission type.
engineRecommendedThe vehicles engine details.
passenger_limitRecommendedThe maximum number of passengers the vehicle can accommodate.
cylinderRecommendedThe number of cylinders in the vehicles engine.
door_countRecommendedThe number of doors the vehicle has.
drivetrainRecommendedThe vehicles drivetrain type.
fuel_typeRecommendedThe vehicles fuel type.
city_fuel_economyRecommendedThe city fuel economy in Liters per 100km.
hwy_fuel_economyRecommendedThe highway fuel economy in Liters per 100km.
optionsRecommendedThe options a vehicle has.
imgsRecommendedThe images a vehicle has.

Ensuring that your inventory data complies with these requirements will facilitate a successful Inbound Syndication process, providing accurate and reliable information to potential customers and partners.

What happens if my data does not meet requirements

At HeyAuto, we carefully review each vehicle record. This means that if a specific vehicle does not meet the data requirements, such as missing any of the required fields, it will be rejected from the syndication process. We conduct individual checks for all other vehicles, even if they have previously failed validation. This ensures that we maintain the highest data quality standards throughout the syndication process.

If none of your inventory is being accepted, please contact HeyAutos technical support team at it@heyauto.com for assistance.