API Integration Information

Add a Customer

This API call will add a new customer to Carro Systems for the dealer who is listed in your DealerID key in the data packet sent. Other methods available are Add Lead which adds a lead to the system and Update Customer, which will update an existing customer record based on a unique key.

To call this API, you will need to make a POST call to the URL : https://{api url}/Customer

An example data packet is shown below. The only mandary field is the customers name

{ "APIkey": "jjhk765765jhjkhkhksssllkncsjGHHHJGsbsjsjllss83434772", "DealerID": "4", "externalcustid": "AS12345678", "custtype": "Retail", "salesexecname": "Johnny Wishbone", "contact": { "title": "Mr", "firstname": "Marvin", "lastname": "Macgregory", "companyname": "", "address1": "15 Windsor Gardens", "address2": "Little Hulton", "address3": "", "town": "Manchester", "county": "", "postcode": "M25 0GH", "mobile": "0777 999 1350", "homephone": "", "email": "marvin@testdomain.co.uk", "idnumber": "", "companyno": "", "vatregno": "" }, "privacy": [ { "label": "Dealership Contact", "email": 1, "tel": 1, "sms": 1, "postal": 1, "marketing": 1 }, { "label": "Manufacturer Contact", "email": 0, "tel": 0, "sms": 0, "postal": 0, "marketing": 0 }, { "label": "Third-Party Contact", "email": 0, "tel": 0, "sms": 0, "postal": 0, "marketing": 0 } ], "enquiry": { "sourceofenquiry": "Autotrader", "methodofcontact": "Telephone", "enqvehicle": [ { "price": "20000", "colour": "Black", "fuel": "Petrol", "transmission": "Manual", "newused": "Used", "mileage": "12000", "regno": "HG22 7GH", "vinnumber": "", "make": "Audi", "engineno": "", "model": "Q4", "regdate": "2022-10-12", "spec": "Black Edition", "bodystyle": "", "enginesize": "", "co2": "", "options": "", "vehiclecomments": "", "interiortrim": "Leather", "stockaddescription": "", "vehicletype": "", "modelyear": "" } ], "tradein": [ { "regno": "P3 BYT", "make": "BMW", "colour": "Blue", "trim": "Leather", "engineno": "", "dateofreg": "2007-02-03", "vin": "", "previousowners": "1", "tiv": "", "model": "Z3", "spec": "1.6", "fuel": "Petrol", "transmission": "Manual", "mileage": "23233", "servicehistory": "", "vehiclenotes": "" } ] }, "notes": [ { "description": "This is a note to add to the customer record" } ] }

Not all data fields are required. The example above shows a full data packet, but if you do not have those data fields available to pass in, just remove them from the structure or leave them blank.

A successful call will look like this :

{"message":"Added Successfully","code":100}