Vin | Keet | Documentation

Vin Webhooks

We support webhooks for the following events on the Vin and vAuto platforms:

When a vehicle’s status changes, this webhook event will be triggered with the updated information.

vAuto Vehicle Status Object

`vin.vehicle.created`

Occurs when a vehicle is created in the vAuto inventory.

Sample Response

{
"dealerName":"Van Horn CDJR of Manitowoc",
"linkedAccountId":"72f88e1a-dff7-4705-936d-ba733da1a69d",
"status":1,
"type":"vin.vehicle.created",
"vin":"5N1BT3AB6NC707140"
}

{
  "dealerName": string,
  "linkedAccountId": string,
  "status": integer,
  "type": string,
  "vin": string
}

`vin.vehicle.update`

Occurs when a vehicle is updated in the vAuto inventory.

Sample Response

{
  "item": {
    "vin": "3C4PDDEG2ET315408",
    "status": 1,
    "dealerName": "Van Horn Motors of Sheboygan"
  },
  "fieldsChanged":{
    "status":{
      "from" : 1,
      "to:" : 2
    },
    "dealerName": {
        "from": "Van Horn Honda of Glendale",
        "to": "Van Horn Motors of Sheboygan"
      }
  },
}

{
  "item": {
    "vin": string,
    "status": integer,
    "dealerName": string
  },
  "fieldsChanged":{
    "status":{
      "from" : integer,
      "to:" : integer
    },
    "dealerName": {
        "from": string,
        "to": string
      }
  },
}

`vin.vehicle.deleted`

Occurs when a vehicle is deleted from the vAuto inventory, usually because it was sold.

Sample Response

{
"dealerName":"Van Horn CDJR of Manitowoc",
"linkedAccountId":"72f88e1a-dff7-4705-936d-ba733da1a69d",
"status":1,
"type":"vin.vehicle.deleted",
"vin":"5N1BT3AB6NC707140"
}

{
  "dealerName": string,
  "linkedAccountId": string,
  "status": integer,
  "type": string,
  "vin": string
}

Vin Appointment Status Object

When a customer’s appointment changes, this webhook event will be triggered with the updated information.

`vin.appointment.created`

Occurs when an appointment is created in the Vin system.

Sample Response

{
  "dealerId": 5227,
  "appointmentId": 123623823,
  "status": "COMPLETED"
}

{
  dealerId : integer,
  appointmentId : integer,
  status : 'ACTIVE' | 'MISSED' | 'COMPLETED' | 'CANCELED'
}

`vin.appointment.statusUpdated`

Occurs when an appointment is updated in the Vin system.

Sample Response

{
  "appointmentId":123859149,
  "dealerId":18192,
  "fieldsChanged":  
    {
      "status":
      { 
        "from": "ACTIVE",
        "to": "COMPLETED"
      }
    },
  "linkedAccountId": "72f88e1a-dff7-4705-936d-ba733da1a69d",
  "status": "COMPLETED",
  "type": "vin.appointment.statusUpdated"
}

{
  "appointmentId": integer,
  "dealerId": integer,
  "fieldsChanged":  
    {
      "status":
      { 
        "from": "ACTIVE" | "MISSED" | "COMPLETED" | "CANCELED",
        "to": "ACTIVE" | "MISSED" | "COMPLETED" | "CANCELED"
      }
    },
  "linkedAccountId": string,
  "status": "ACTIVE" | "MISSED" | "COMPLETED" | "CANCELED",
  "type": string
}