> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.trykeet.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.trykeet.com/_mcp/server.

### Vin Webhooks

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

* [vAuto Vehicles](vin#vauto-vehicle-status-object)
* [Vin Appointments](vin#vin-appointment-status-object)

---

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

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

```tsx
{
  "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

```json

{
  "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"
      }
  },
}
```

```tsx
{
  "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

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

```tsx
{
  "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

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

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

#### `vin.appointment.statusUpdated`

Occurs when an appointment is updated in the Vin system.

#### Sample Response

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

```tsx
{
  "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
}


```