Skip to content

DMS/Aggregator Webhook Integration

These docs are used for third party suppliers who wish to post items (eg. cars, trucks boats) into the Autotrader platform. In this case, please use the below payload structure. The dealership_name and external_dealership_identifier are from the supplier. The endpoint will be required upon request and may be dedicated per supplier.

{
"rego": "XYZ123",
"dealership_name": "North West Dealership",
"provider_name": "Cox Automotive",
"external_dealership_identifier": "123",
"rego_expiry": "31/12/2023",
"stocknum": "S12345",
"vin": "1HGBH41JXMN109186",
"location_code": "123",
"odometer": 12345,
"dapprice": 29990,
"egcprice": 31990,
"make": "Toyota",
"model": "Corolla",
"badge": "Ascent Sport",
"series": "ZRE182R",
"year": 2023,
"cylinders": 4,
"engine_type": null,
"engine_capacity": "1.5",
"induction": null,
"fuel_type": "Petrol - Unleaded",
"engine_number": "**********",
"body": "Hatch",
"colour": "White",
"redbook_code": "*****",
"nvic_code": "*****",
"interior_colour": "Black",
"transmission": "automatic",
"fuel": "Petrol",
"certified": true,
"doors": 5,
"seats": 4,
"drive": "FWD",
"dealercomments": "This car is in excellent condition.",
"features": ["Air Conditioning", "Bluetooth", "Cruise Control"],
"status": "in_stock",
"car_type": "new",
"item_type": "car",
"compliance_date": "01/01/2023",
"build_date": "01/01/2023",
"show_on_dealer_website": true,
"images": ["https://www.example.com/image1.jpg", "https://www.example.com/image2.jpg"],
"external_video_url": "https://www.youtube.com/watch?v=12345"
}

Most fields are self explanatory, however certain fields are given descriptions below for clarity:

Column NameDescriptionMandatory
StocknumY
MakeY
ModelY
YearY
StatusY
CertifiedWhether the vehicle is manufacturer certifiedN
Provider nameThe name of the third party systemN
External dealership identifierThe item identifier from the third party systemN
FeaturesThe features on the car eg. Sun roof, tow bar etc. If you provide a catalogue code (eg. NVIC or Redbook), this will be prefilled with the data from the catalogue.N