Webhooks 1.0 Reference
Submit FeedbackWe are alway open to product feedback - whether it's more webhooks you want to see, enhancements to existing webhooks, or anything webhooks related! Submit feedback here.
Alert Events
Alert EventsAlert events are what primarily trigger webhook notifications. These events are triggered by the alerts that you have configured in the Samsara dashboard. See the Webhooks guide for more details on creating and configuring alerts.
An event that has an eventType of Alert has the following fields:
| Field | Description |
|---|---|
alertEventUrl | A link to the alert in the Samsara dashboard. |
alertConditionDescription | A human-readable string describing the condition that triggered the alert. |
alertConditionId | The ID of the condition that triggered the alert. This tells you the type of alert for this event. |
details | A human-readable string that contains dynamic details on the alert. |
orgId | The ID of your organization. This can be helpful in debugging the issue when contacting support. |
resolved | Describes whether the alert has been resolved. Because alerts are not resolved when they are created, this will always be false in a webhook notification. |
startMs | The Unix epoch timestamp of when the event was triggered. This comes from either the Samsara gateway, the mobile device, or the service originating the alert in cloud. This is different from For example, |
summary | A brief summary of the event. |
| Additional fields | Depending on the type of alert, additional fields may be available. |
For example:
{
"eventId": "bf72239c-bebd-4c22-b64c-6fc692ef7c46",
"eventMs": 1587597109477,
"eventType": "Alert",
"event": {
"alertEventUrl": "https://cloud.samsara.com/o/53729/alerts/incidents/v2/159827/1/212014918732717/1587596963539/link?dl=eyJkZWVwTGlua1R5cGUiOiJBbGVydENvbmRpdGlvblR5cGVfRGV2aWNlTG9jYXRpb25JbnNpZGVHZW9mZW5jZSIsImdyb3VwSWQiOjU0ODY4fQ==",
"alertConditionDescription": "Vehicle is inside geofence",
"alertConditionId": "DeviceLocationInsideGeofence",
"details": "'Little Red' is inside Parent's House.",
"orgId": 53729,
"resolved": false,
"startMs": 1587596963539,
"summary": "'Little Red' is inside Parent's House.",
...additional fields specific to the alert condition
}
}See below for details on different types of alerts.
Fault Codes
| Field | Value |
|---|---|
alertConditionId | DeviceHasVehicleFault |
alertConditionDescription | Vehicle has fault |
device | id - integer - ID of the Vehiclename - string - Name of the Vehicleserial - string - Device serial numbervin - string - VIN of the Vehicle |
details | For J1939 vehicles:
Vehicle 'Little Red' reported a fault. Check engine lights: warning, emissions. Vehicle faults: TxId: 11, SPN: 627 - Power Supply (obsolete), FMI: 4 (Voltage Below Normal), Count: 127; TxId: 0, SPN: 656 - Engine Injector Cylinder #06, FMI: 5 (Current Below Normal), Count: 5; TxId: 0, SPN: 1127 - Engine Turbocharger 1 Boost Pressure, FMI: 18 (Low—moderate severity), Count: 6; TxId: 0, SPN: 3490 - Aftertreatment 1 Purge Air Actuator, FMI: 12 (Failure), Count: 1; TxId: 0, SPN: 1659 - Engine Coolant System Thermostat, FMI: 12 (Failure), Count: 9; TxId: 0, SPN: 3226 - Aftertreatment 1 Outlet NOx, FMI: 5 (Current Below Normal), Count: 1; TxId: 0, SPN: 641 - Engine Variable Geometry Turbocharger Actuator #1, FMI: 4 (Voltage Below Normal), Count: 2.For OBD-II vehicles: Example: |
{
"eventId": "e3645383-32f1-4c66-a5e6-983b2e456e77",
"eventMs": 1600792716481,
"eventType": "Alert",
"event": {
"alertEventUrl": "https://cloud.samsara.com/o/53729/alerts/incidents/v2/159469/1/281474977075805/1600792716481/link?dl=NDA5ZjU2OGUtYzhmMi00N2IzLWJmNDktMDU0YmJiYTY0YTg0OlJ1Uk9BaExjYklMSHdDWmRZdFJnYzR1alJaRlFmbXBw",
"alertConditionDescription": "Vehicle has fault",
"alertConditionId": "DeviceHasVehicleFault",
"details": "Vehicle 'Little Red' reported a fault. Check engine lights: warning, emissions. Vehicle faults: TxId: 11, SPN: 627 - Power Supply (obsolete), FMI: 4 (Voltage Below Normal), Count: 127; TxId: 0, SPN: 656 - Engine Injector Cylinder #06, FMI: 5 (Current Below Normal), Count: 5; TxId: 0, SPN: 1127 - Engine Turbocharger 1 Boost Pressure, FMI: 18 (Low—moderate severity), Count: 6; TxId: 0, SPN: 3490 - Aftertreatment 1 Purge Air Actuator, FMI: 12 (Failure), Count: 1; TxId: 0, SPN: 1659 - Engine Coolant System Thermostat, FMI: 12 (Failure), Count: 9; TxId: 0, SPN: 3226 - Aftertreatment 1 Outlet NOx, FMI: 5 (Current Below Normal), Count: 1; TxId: 0, SPN: 641 - Engine Variable Geometry Turbocharger Actuator #1, FMI: 4 (Voltage Below Normal), Count: 2.",
"device": {
"id": 281474977075805,
"name": "Little Red",
"serial": "G9MTH7CNKZ",
"vin": "JTMBK32V895081147"
},
"orgId": 53729,
"resolved": false,
"startMs": 1600792612258,
"summary": "Vehicle 'Little Red' reported a fault."
}
}Vehicle Unplugged
| Field | Value |
|---|---|
alertConditionId | DeviceUnplugged |
alertConditionDescription | Gateway unplugged |
device | id - integer - ID of the Vehiclename - string - Name of the Vehicleserial - string - Device serial numbervin - string - VIN of the Vehicle |
details | '{deviceName}' has been unplugged. |
{
"eventId": "e3645383-32f1-4c66-a5e6-983b2e456e77",
"eventMs": 1600358734385,
"eventType": "Alert",
"event": {
"alertEventUrl": "https://cloud.samsara.com/o/53729/alerts/incidents/v2/159469/1/281474977075805/1600358734385/link?dl=NDA5ZjU2OGUtYzhmMi00N2IzLWJmNDktMDU0YmJiYTY0YTg0OlJ1Uk9BaExjYklMSHdDWmRZdFJnYzR1alJaRlFmbXBw",
"alertConditionDescription": "Gateway unplugged",
"alertConditionId": "DeviceUnplugged",
"details": "'Little Red' has been unplugged.",
"device": {
"id": 281474977075805,
"name": "Little Red",
"serial": "G9MTH7CNKZ",
"vin": "JTMBK32V895081147"
},
"orgId": 53729,
"resolved": false,
"startMs": 1600358684449,
"summary": "'Little Red' has been unplugged."
}
}Harsh Event
| Field | Value |
|---|---|
alertConditionId | HarshEvent |
alertConditionDescription | A harsh event has occurred. |
details |
{triggerReason}:
{startTime}: Sep 15 3:17PM EDT |
device | id - integer - ID of the Vehiclename - string - Name of the Vehicleserial - string - Device serial numbervin - string - VIN of the Vehicle |
{
"eventId": "e3645383-32f1-4c66-a5e6-983b2e456e77",
"eventMs": 1600197540637,
"eventType": "Alert",
"event": {
"alertEventUrl": "https://cloud.samsara.com/o/53729/alerts/incidents/v2/159469/1/281474977075805/1600197425460/link?dl=NDA5ZjU2OGUtYzhmMi00N2IzLWJmNDktMDU0YmJiYTY0YTg0OlJ1Uk9BaExjYklMSHdDWmRZdFJnYzR1alJaRlFmbXBw",
"alertConditionDescription": "A harsh event has occurred.",
"alertConditionId": "HarshEvent",
"details": "A Harsh Brake was detected on vehicle Little Red at Sep 15 3:17PM EDT. Incident report: https://cloud.samsara.com/o/53729/fleet/reports/safety/vehicle/281474977075805/incident/1600197425460",
"device": {
"id": 281474977075805,
"name": "Little Red",
"serial": "G9MTH7CNKZ",
"vin": "JTMBK32V895081147"
},
"orgId": 53729,
"resolved": false,
"startMs": 1600197425460,
"summary": "A Harsh Brake was detected on vehicle Little Red at Sep 15 3:17PM EDT."
}
}Geofence
| Field | Value |
|---|---|
alertConditionId | DeviceLocationInsideGeofenceDeviceLocationOutsideGeofence |
alertConditionDescription | Vehicle is inside geofenceVehicle is outside geofence |
details |
With duration: |
device | id - integer - ID of the Vehicle or Assetname - string - Name of the Vehicle or Assetserial - string - Device serial numbervin - string - VIN if the gateway is tied to a vehicle |
{
"eventId": "e3645383-32f1-4c66-a5e6-983b2e456e77",
"eventMs": 1600796684212,
"eventType": "Alert",
"event": {
"alertEventUrl": "https://cloud.samsara.com/o/53729/alerts/incidents/v2/159469/1/281474977075805/1600796684212/link?dl=NDA5ZjU2OGUtYzhmMi00N2IzLWJmNDktMDU0YmJiYTY0YTg0OlJ1Uk9BaExjYklMSHdDWmRZdFJnYzR1alJaRlFmbXBw",
"alertConditionDescription": "Vehicle is inside geofence",
"alertConditionId": "DeviceLocationInsideGeofence",
"details": "'Little Red' is inside Garage.",
"device": {
"id": 281474977075805,
"name": "Little Red",
"serial": "G9MTH7CNKZ",
"vin": "JTMBK32V895081147"
},
"orgId": 53729,
"resolved": false,
"startMs": 1600796604125,
"summary": "'Little Red' is inside Garage."
}
}Document Submission
| Field | Value |
|---|---|
alertConditionId | DriverDocumentSubmitted |
alertConditionDescription | Document Submission |
details | A {documentTemplateName} document was submitted by {driverName} at {submissionTime}. Document: {documentUrl} (ID: {documentId}) |
driver | id - integer - ID of the Drivername - string - Name of the Driver |
{
"eventId": "e3645383-32f1-4c66-a5e6-983b2e456e77",
"eventMs": 1600198798204,
"eventType": "Alert",
"event": {
"alertEventUrl": "https://cloud.samsara.com/o/53729/alerts/incidents/v2/197865/5/1654973/1600198797529",
"alertConditionDescription": "Document Submission",
"alertConditionId": "DriverDocumentSubmitted",
"details": "A Stop Tasks document was submitted by Tyler Freckmann at Tue, 15 Sep 2020 12:39pm PDT. Document: https://cloud.samsara.com/o/53729/groups/54868/fleet/reports/documents/1654973/1600198797529 (ID: 1654973_1600198797529)",
"driver": {
"id": 1654973,
"name": "Tyler Freckmann"
},
"orgId": 53729,
"resolved": false,
"startMs": 1600198797529,
"summary": "Stop Tasks Submitted"
}
}Speed
| Field | Value |
|---|---|
alertConditionId | For alerting on a specific speed: For alerting on above speed limit: |
alertConditionDescription | For alerting on a specific mph: For alerting on above speed limit: |
details | For alerting on a specific mph: For alerting on above speed limit: For alerting on above speed limit by percentage: |
device | id - integer - ID of the Vehicle or Assetname - string - Name of the Vehicle or Assetserial - string - Device serial numbervin - string - VIN if the gateway is tied to a vehicle |
For alerting on a specific speed:
{
"eventId": "e3645383-32f1-4c66-a5e6-983b2e456e77",
"eventMs": 1600389485649,
"eventType": "Alert",
"event": {
"alertEventUrl": "https://cloud.samsara.com/o/53729/alerts/incidents/v2/159469/1/281474977075805/1600389448003/link?dl=NDA5ZjU2OGUtYzhmMi00N2IzLWJmNDktMDU0YmJiYTY0YTg0OlJ1Uk9BaExjYklMSHdDWmRZdFJnYzR1alJaRlFmbXBw",
"alertConditionDescription": "Vehicle speed",
"alertConditionId": "DeviceSpeedAbove",
"details": "'Little Red' speed is above 20 mph. Currently 33 mph. Location: Telegraph Road, Rose Hill, VA, US",
"device": {
"id": 281474977075805,
"name": "Little Red",
"serial": "G9MTH7CNKZ",
"vin": "JTMBK32V895081147"
},
"orgId": 53729,
"resolved": false,
"startMs": 1600389448003,
"summary": "'Little Red' speed has risen above 20 mph."
}
}For alerting on above speed limit:
{
"eventId": "e3645383-32f1-4c66-a5e6-983b2e456e77",
"eventMs": 1600796168405,
"eventType": "Alert",
"event": {
"alertEventUrl": "https://cloud.samsara.com/o/53729/alerts/incidents/v2/159469/1/281474977075805/1600796111005/link?dl=NDA5ZjU2OGUtYzhmMi00N2IzLWJmNDktMDU0YmJiYTY0YTg0OlJ1Uk9BaExjYklMSHdDWmRZdFJnYzR1alJaRlFmbXBw",
"alertConditionDescription": "Vehicle speed above speed limit",
"alertConditionId": "DeviceSpeedAboveSpeedLimit",
"details": "'Little Red' speed is above speed limit by 14 mph. Currently 65 mph. Location: Major Deegan Expressway, NY, US",
"device": {
"id": 281474977075805,
"name": "Little Red",
"serial": "G9MTH7CNKZ",
"vin": "JTMBK32V895081147"
},
"orgId": 53729,
"resolved": false,
"startMs": 1600796111005,
"summary": "'Little Red' speed has risen above speed limit by 14 mph."
}
}Movement
| Field | Value |
|---|---|
alertConditionId | DeviceMovement |
alertConditionDescription | Vehicle/Asset has started moving |
details |
With duration: |
device | id - integer - ID of the Vehicle or Assetname - string - Name of the Vehicle or Assetserial - string - Device serial numbervin - string - VIN if the gateway is tied to a vehicle |
{
"eventId": "e3645383-32f1-4c66-a5e6-983b2e456e77",
"eventMs": 1600801041397,
"eventType": "Alert",
"event": {
"alertEventUrl": "https://cloud.samsara.com/o/53729/alerts/incidents/v2/159469/1/281474977075805/1600801000010/link?dl=NDA5ZjU2OGUtYzhmMi00N2IzLWJmNDktMDU0YmJiYTY0YTg0OlJ1Uk9BaExjYklMSHdDWmRZdFJnYzR1alJaRlFmbXBw",
"alertConditionDescription": "Vehicle/Asset has started moving",
"alertConditionId": "DeviceMovement",
"details": "'Little Red' is moving.",
"device": {
"id": 281474977075805,
"name": "Little Red",
"serial": "G9MTH7CNKZ",
"vin": "JTMBK32V895081147"
},
"orgId": 53729,
"resolved": false,
"startMs": 1600801000010,
"summary": "'Little Red' is moving."
}
}Vehicle Engine Idle
| Field | Value |
|---|---|
alertConditionId | EngineIdle |
alertConditionDescription | Engine idle |
details | '{deviceName}' engine has been idle for more than {durationMins} minutes at {location}. |
device | id - integer - ID of the Vehicle or Assetname - string - Name of the Vehicle or Assetserial - string - Device serial numbervin - string - VIN if the gateway is tied to a vehicle |
{
"eventId": "e3645383-32f1-4c66-a5e6-983b2e456e77",
"eventMs": 1600801772597,
"eventType": "Alert",
"event": {
"alertEventUrl": "https://cloud.samsara.com/o/53729/alerts/incidents/v2/159469/1/281474977075805/1600801598939/link?dl=NDA5ZjU2OGUtYzhmMi00N2IzLWJmNDktMDU0YmJiYTY0YTg0OlJ1Uk9BaExjYklMSHdDWmRZdFJnYzR1alJaRlFmbXBw",
"alertConditionDescription": "Engine idle",
"alertConditionId": "EngineIdle",
"details": "'Little Red' engine has been idle for more than 1 minutes at Laredo, TX.",
"device": {
"id": 281474977075805,
"name": "Little Red",
"serial": "G9MTH7CNKZ",
"vin": "JTMBK32V895081147"
},
"orgId": 53729,
"resolved": false,
"startMs": 1600801598939,
"summary": "'Little Red' engine has been idle for more than 1 minutes."
}
}Device Battery Level
| Field | Value |
|---|---|
alertConditionId | BatteryLow |
alertConditionDescription | Battery is low |
details | '{deviceName}' is running low on battery. |
device | id - integer - ID of the Vehicle or Assetname - string - Name of the Vehicle or Assetserial - string - Device serial numbervin - string - VIN if the gateway is tied to a vehicle |
{
"eventId": "e3645383-32f1-4c66-a5e6-983b2e456e77",
"eventMs": 1600787321448,
"eventType": "Alert",
"event": {
"alertEventUrl": "https://cloud.samsara.com/o/53729/alerts/incidents/v2/196696/1/281474977075805/1600787301326",
"alertConditionDescription": "Battery is low",
"alertConditionId": "BatteryLow",
"details": "'Little Red' is running low on battery.",
"device": {
"id": 281474977075805,
"name": "Little Red",
"serial": "G9MTH7CNKZ",
"vin": "JTMBK32V895081147"
},
"orgId": 53729,
"resolved": false,
"startMs": 1600787301326,
"summary": "'Little Red' is running low on battery."
}
}Dash Cam Disconnected
| Field | Value |
|---|---|
alertConditionId | DashcamDisconnected |
alertConditionDescription | Dashcam disconnected |
details | Dashcam on '{deviceName}' was disconnected. Please verify that the dashcam is plugged in. |
device | id - integer - ID of the Vehiclename - string - Name of the Vehicleserial - string - Device serial numbervin - string - VIN of the Vehicle |
{
"eventId": "e3645383-32f1-4c66-a5e6-983b2e456e77",
"eventMs": 1600792429405,
"eventType": "Alert",
"event": {
"alertEventUrl": "https://cloud.samsara.com/o/53729/alerts/incidents/v2/176185/1/281474977170705/1600792368708",
"alertConditionDescription": "Dashcam disconnected",
"alertConditionId": "DashcamDisconnected",
"details": "Dashcam on 'Little Red' was disconnected. Please verify that the dashcam is plugged in.",
"device": {
"id": 281474977075805,
"name": "Little Red",
"serial": "G9MTH7CNKZ",
"vin": "JTMBK32V895081147"
},
"orgId": 53729,
"resolved": false,
"startMs": 1600792368708,
"summary": "Dashcam on 'Little Red' was disconnected. Please verify that the dashcam is plugged in."
}
}Driver HOS Violation
| Field | Value |
|---|---|
alertConditionId | HosViolation |
alertConditionDescription | HOS violation |
details |
With duration: Preemptive alert: {violation}:
|
driver | id - integer - ID of the Drivername - string - Name of the Driver |
{
"eventId": "e3645383-32f1-4c66-a5e6-983b2e456e77",
"eventMs": 1600726114837,
"eventType": "Alert",
"event": {
"alertEventUrl": "https://cloud.samsara.com/o/53729/alerts/incidents/v2/197865/5/1654973/1600726113578",
"alertConditionDescription": "HOS violation",
"alertConditionId": "HosViolation",
"details": "'Tyler Freckmann' is in violation of hours of service. Shift Duty Limit (USA-14 hours).",
"driver": {
"id": 1654973,
"name": "Tyler Freckmann"
},
"orgId": 53729,
"resolved": false,
"startMs": 1600726113578,
"summary": "'Tyler Freckmann' is in violation of hours of service."
}
}Vehicle Fuel Level
| Field | Value |
|---|---|
alertConditionId | VehicleFuelLevelBelow |
alertConditionDescription | Fuel level is low |
details | Fuel level below threshold: Fuel level below threshold with duration: Fuel level decrease: |
device | id - integer - ID of the Vehiclename - string - Name of the Vehicleserial - string - Device serial numbervin - string - VIN of the Vehicle |
{
"eventId": "e3645383-32f1-4c66-a5e6-983b2e456e77",
"eventMs": 1600982158359,
"eventType": "Alert",
"event": {
"alertEventUrl": "https://cloud.samsara.com/o/53729/alerts/incidents/v2/159469/1/281474977075805/1600966253076/link?dl=NDA5ZjU2OGUtYzhmMi00N2IzLWJmNDktMDU0YmJiYTY0YTg0OlJ1Uk9BaExjYklMSHdDWmRZdFJnYzR1alJaRlFmbXBw",
"alertConditionDescription": "Fuel level is low",
"alertConditionId": "VehicleFuelLevelBelow",
"details": "Little Red fuel level has fallen below 25% for more than 10 minutes",
"device": {
"id": 281474977075805,
"name": "Little Red",
"serial": "G9MTH7CNKZ",
"vin": "JTMBK32V895081147"
},
"orgId": 53729,
"resolved": false,
"startMs": 1600966253076,
"summary": "Little Red fuel level has fallen below 25% for more than 10 minutes"
}
}Temperature
| Field | Value |
|---|---|
alertConditionId | TemperatureBelowTemperatureAbove |
alertConditionDescription | Ambient temperature is belowAmbient temperature is above |
details | For sensors:
For probes:
|
sensor | id - integer - Sensor IDname - string - Sensor nameserial - string - Sensor serial number |
Humidity
| Field | Value |
|---|---|
alertConditionId | HumidityBelowHumidityAbove |
alertConditionDescription | Humidity is aboveHumidity is below |
details |
|
sensor | id - integer - Sensor IDname - string - Sensor nameserial - string - Sensor serial number |
Connection
| Field | Value |
|---|---|
alertConditionId | DeviceDisconnect |
alertConditionDescription | Gateway is offline |
details | Sensor '{deviceName}' disconnected. Live alerts will not be sent for this sensor while it's offline. |
device | id - integer - ID of the Vehicle or Assetname - string - Name of the Vehicle or Assetserial - string - Device serial numbervin - string - VIN if the gateway is tied to a vehicle |
Vehicle Battery
| Field | Value |
|---|---|
alertConditionId | BatteryVoltageBelow |
alertConditionDescription | Battery voltage below |
details | {deviceName}' vehicle battery level has fallen below {threshold} V for more than {duration} minutes. It is currently {batteryValue} V. |
device | id - integer - ID of the Vehicle or Assetname - string - Name of the Vehicle or Assetserial - string - Device serial numbervin - string - VIN if the gateway is tied to a vehicle |
Door Open
| Field | Value |
|---|---|
alertConditionId | DoorActivated |
alertConditionDescription | Door opened |
details |
If the alert has been configured to trigger after |
sensor | id - integer - Sensor IDname - string - Sensor nameserial - string - Sensor serial number |
Route Stop Arrival
| Field | Value |
|---|---|
alertConditionId | DispatchRouteETAThreshold |
alertConditionDescription | Dispatch Route ETA Threshold |
details | Vehicle {deviceName} on route {routeName} is approximately {timeToDestination} minutes away from {stopName} |
device | id - integer - ID of the Vehiclename - string - Name of the Vehicleserial - string - Device serial numbervin - string - VIN of the Vehicle |
route | id - integer - ID of the Routename - string - Name of the Route |
Reefer Alarm
| Field | Value |
|---|---|
alertConditionId | ReeferHasNewAlarm |
alertConditionDescription | A new reefer alarm occurred |
device | id - integer - ID of the Assetname - string - Name of the Assetserial - string - Device serial number |
Reefer Temperature
| Field | Value |
|---|---|
alertConditionId | ReeferTemperatureAboveSetPointReeferTemperatureBelowSetPoint |
alertConditionDescription | Reefer return air temperature above set point.Reefer return air temperature below set point. |
device | id - integer - ID of the Assetname - string - Name of the Assetserial - string - Device serial number |
Scheduled Maintenance
| Field | Value |
|---|---|
alertConditionId | ScheduledMaintenanceDateScheduledMaintenanceEngineHoursScheduledMaintenanceOdometer |
alertConditionDescription |
|
details |
|
device | id - integer - ID of the Vehicle or Assetname - string - Name of the Vehicle or Assetserial - string - Device serial numbervin - string - VIN if the gateway is tied to a vehicle |
Unsafe DVIR
| Field | Value |
|---|---|
alertConditionId | UnsafeDvir |
alertConditionDescription | Unsafe DVIR submitted |
details | Asset: {vehicleName}\nDriver: {driverName}\n\nThe following defects were reported:\n\n{defectType}: {defectComment},\n\nDVIR url: {dvirUrl} |
device | id - integer - ID of the Vehicle or Trailername - string - Name of the Vehicle or Trailer |
driver | id - integer - ID of the Drivername - string - Name of the Driver |
dvir |
|
For example:
{
"eventId": "b9e76b68-900b-4af3-9fd3-96ed6f27a88e",
"eventMs": 1589573824918,
"eventType": "Alert",
"event": {
"alertEventUrl": "https://cloud.samsara.com/o/53729/alerts/incidents/v2/165861/1/281474977075805/1589573819765/link?dl=eyJkZWVwTGlua1R5cGUiOiJBbGVydENvbmRpdGlvblR5cGVfVW5zYWZlRHZpciIsImdyb3VwSWQiOjU0ODY4fQ==",
"alertConditionDescription": "Unsafe DVIR submitted",
"alertConditionId": "UnsafeDvir",
"details": "Asset: Little Red\nDriver: Tyler Freckmann\n\nThe following defects were reported:\nAir Compressor: Comment\n\nDVIR url: https://cloud.samsara.com/o/53729/fleet/maintenance/dvir/38369954",
"device": {
"id": 281474977075805,
"name": "Little Red"
},
"driver": {
"id": 1654973,
"name": "Tyler Freckmann"
},
"dvir": {
"dvirId": "38369954",
"vehicle": {
"id": "281474977075805",
"name": "Little Red"
},
"driver": {
"id": "1654973",
"name": "Tyler Freckmann"
},
"odometer": 197949,
"inspectionType": "preTrip",
"safetyStatus": "unsafe",
"walkaroundPhotos": [
{
"url": "https://samsara-driver-media-upload.s3.us-west-2.amazonaws.com/orgs/53729/drivers/1654973/29eabaa7-d6b9-4dd3-8aff-f23dc6d37200/AC10399B-E301-41C5-946C-11B6B80EA783.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA3LY3RNWSIVJ5WOCV%2F20200515%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20200515T205221Z&X-Amz-Expires=86400&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEE0aCXVzLXdlc3QtMiJHMEUCIAQbZF9%2FS7hnLncY%2BDskT4plGylrxz%2FZDOexhX7gwO7YAiEAwE2kO5s0ZTx38XFH81UkHAqi7zA3pFzZJKKyAlUqp7Eq4wMIlv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FARACGgw3ODEyMDQ5NDIyNDQiDLb7Q6J4fpqhHf66LSq3AyZWH2EHvoF8wYdr66EFrYBV0l%2FSxBHYJXWTj9YAb4ncoTyIH3yojNcvRZwsF9koN3iy%2BASpIVHky98fGqBhyktFz6urMiqoRAY7BJ%2F%2BbAkPWTdH%2B1jRMdU2wbyA7s8YtxNL4WtkzTONfXDwsReGzR0qJvb17zYGsja6f6S3eqYabY5ySh%2B%2B7wtOYe2Rayj21ZNwampBLbvrDesdwFkOuYMr47g6Egs6klxeMi49NCRFAxncOsqXQdwqGcU1XyZ2C7rcARKm5vD8GR7ptqsK8K%2B1UKZzPcG1z8nEdCXuMtJr%2FGuwGLqbvSmzGiGC5lNidVIzYTLfp%2BbVKqEgmHsFe9MtfAQ8bGXYmA%2FmhURcJTrwpFhHhVHAIM0zkFUYVQYZbUCj4xmzTtwQ9HnnQojl3wVZxie3MRf%2FkNNQRFN7FtaSu617NTnENp5FuR4k7H9kBqa22sYQb5AqNv5qlSN9HhPvVvB6s0YB0ubJdCNOvuVKlOPjaffzc109j6c%2FIJZEN9LEs5mvJ9foDiuW7StUpmqHbE6eWneiSaaf%2BscShutzKD2QuAD5m0YZIwgjbyTZbe47h5ztI9MwmoD89QU67wHvL5MThEViBq8lfZQtyYiMnSNKtAW8KEdcXc49BCy9SsEseVFLABsHN0bi2X5zAgv7gVjqm6sxYjlAj9PuJ23%2BMEVsFUx93PdrDeutaFPrK3tCFDXYcAruAgLlA%2FNu%2BWGUerwNoTK71xW56ZS4N8Ef5YY3MS96bsq2U54V3JoTpgvRzyJICtVSZwzIb8S5honEHFyrsUL2iJkWX%2BKniRSt15tPjI8kSAEt%2BsFPTCe6iOZKG06%2FF6NJL7NTVHp2SIv4vPSz5I1J2MStW96l3UWUYlEkpbuQ7OQaL3I20UNLupyxZ8pBVhfZu8maCFmwmA%3D%3D&X-Amz-SignedHeaders=host&response-expires=2020-05-16T20%3A52%3A21Z&X-Amz-Signature=d3fc1d088e29364850dba23aa39a70dec1f1af5c6e53cde70bc01e5c95f639c9"
}
],
"defects": [
{
"id": "2144238",
"createdAt": "2020-05-15T20:16:37.285Z",
"defectType": "Air Compressor",
"comment": "Comment",
"photos": [
{
"url": "https://samsara-driver-media-upload.s3.us-west-2.amazonaws.com/orgs/53729/drivers/1654973/35ef641a-d155-4c06-aca6-bc55ccc8ce47/B249F7C5-FF55-40CD-ACA4-51E1DB4F75E7.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA3LY3RNWSDJ2QV4X2%2F20200515%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20200515T205221Z&X-Amz-Expires=86400&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEE0aCXVzLXdlc3QtMiJHMEUCIEz8Pg7xeN4UVBn6CL%2BqpjMq75Kfwv59nfkfWscCfaGxAiEA0gIgZCVo3ZOejG9M2JVs6yNaN9SdUx2lhenzBmaZr6Qq4wMIlv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FARACGgw3ODEyMDQ5NDIyNDQiDNrWAS0XJfk3OiHO2Sq3A7ZeZhiVIlAXYqH6Vj6x3j8tXC7%2BCpSVNePptKAA6EyGc9HSZsWiRvTQ0w%2FJigi1JwWPwI1VGmSCrbxjjd3IJ089UqDnl9SssoiRP%2FoMSdhUOpa8HeY7Hjvkr7GaIW%2FWiIh4s9y2mNCvDjObgswxqS6jIu4x7dgt2g78zqcKSxqRx3lcaw3AWBC5H%2Fi4kdyOwi%2BTYIKhPJvUb2yskRgxD27KYjr85PHX8Uk%2BRmUY2%2BhVtkfgAz0GBGvQdPCMgkojyPqqOkve4sggXaZd0YDqXwdiPUcjoIkT47sne55EclJwb%2FuBg8DcG6Vgcf4swJZGnn1q%2FIN%2BdggHf4DkgFCw%2Fbw1HpxwdXhpAs9UZRPmwvs34HfgB6Mh0lyQr7T1NdYPHfDQ8CkjgRZOkDpA%2FnCoD1x%2FiAKhSykDe16LIgcyqm2AhMzyEM8Gk5VC0ChlrBbTj1%2FiktyXto6b0%2BJpcJmuURyHk%2BYqkPkI1g8AP%2F4IqodMBCXQmWSllzzRkgdfvesnjSmWDosMN1YFL9i%2F1MXFaMn0X9KGjrPNicLW6tWhuJ9r%2F7eZzSkEMLZ3jd6rbZt7QOrzdlbcPkAwmoD89QU67wEXnu%2Bgl5EeUpydodC1%2FmZFjbDeESLke4QfApkJWNU7XlQt%2Bfo7SPQtupkkTvZ5XpbnV%2BhoELK0uE3gaILC4R2y3h1yEkylZoqA7F3MvLlkLgqt3rmPq3fPiPWjK663yd7ZmHMwLyjNq5Opg55kBZ8W%2FwlYct%2Fy%2FO6RIiSoZlzOqRRaNBcEFFVozwqYOHbVMo1cz9WofehLKErB78voHxr1CgEspaumZFDIIiPEZR9%2Bm1Ovh7aHrtf3KYYg7TNDm5mBXrJJQcABoh6Hp1WEpGoZdZycFmq5m3Ha8oecKKHp5zhh2KnlkzK8yIAzCZH3bg%3D%3D&X-Amz-SignedHeaders=host&response-expires=2020-05-16T20%3A52%3A21Z&X-Amz-Signature=7aeffa918c0d15893ba1a6cd60add35d3fb315e1f193df247d114c05475e82a2"
}
]
}
]
},
"orgId": 53729,
"resolved": false,
"startMs": 1589573819765,
"summary": "Unsafe DVIR submitted"
}
}Safe DVIR with Defects
| Field | Value |
|---|---|
alertConditionId | SafeDvirWithDefects |
alertConditionDescription | Safe DVIR with defects submitted |
details | Asset: {vehicleName}\nDriver: {driverName}\n\nThe following defects were reported:\n\n{defectType}: {defectComment},\n\nDVIR url: {dvirUrl} |
device | id - integer - ID of the Vehicle or Trailername - string - Name of the Vehicle or Trailer |
driver | id - integer - ID of the Drivername - string - Name of the Driver |
dvir |
|
For example:
{
"eventId": "a111f565-8fa5-478c-a782-2a295f2c0412",
"eventMs": 1589575941984,
"eventType": "Alert",
"event": {
"alertEventUrl": "https://cloud.samsara.com/o/53729/alerts/incidents/v2/165920/1/281474977075805/1589575936728/link?dl=eyJkZWVwTGlua1R5cGUiOiJBbGVydENvbmRpdGlvblR5cGVfU2FmZUR2aXJXaXRoRGVmZWN0cyIsImdyb3VwSWQiOjU0ODY4fQ==",
"alertConditionDescription": "Safe DVIR with defects submitted",
"alertConditionId": "SafeDvirWithDefects",
"details": "Asset: Little Red\nDriver: Tyler Freckmann\n\nThe following defects were reported:\nAir Compressor: Comment\n\nDVIR url: https://cloud.samsara.com/o/53729/fleet/maintenance/dvir/38373331",
"device": {
"id": 281474977075805,
"name": "Little Red"
},
"driver": {
"id": 1654973,
"name": "Tyler Freckmann"
},
"dvir": {
"dvirId": "38373331",
"vehicle": {
"id": "281474977075805",
"name": "Little Red"
},
"driver": {
"id": "1654973",
"name": "Tyler Freckmann"
},
"odometer": 197949,
"inspectionType": "preTrip",
"safetyStatus": "safe",
"walkaroundPhotos": [
{
"url": "https://samsara-driver-media-upload.s3.us-west-2.amazonaws.com/orgs/53729/drivers/1654973/29eabaa7-d6b9-4dd3-8aff-f23dc6d37200/AC10399B-E301-41C5-946C-11B6B80EA783.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA3LY3RNWSIVJ5WOCV%2F20200515%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20200515T205221Z&X-Amz-Expires=86400&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEE0aCXVzLXdlc3QtMiJHMEUCIAQbZF9%2FS7hnLncY%2BDskT4plGylrxz%2FZDOexhX7gwO7YAiEAwE2kO5s0ZTx38XFH81UkHAqi7zA3pFzZJKKyAlUqp7Eq4wMIlv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FARACGgw3ODEyMDQ5NDIyNDQiDLb7Q6J4fpqhHf66LSq3AyZWH2EHvoF8wYdr66EFrYBV0l%2FSxBHYJXWTj9YAb4ncoTyIH3yojNcvRZwsF9koN3iy%2BASpIVHky98fGqBhyktFz6urMiqoRAY7BJ%2F%2BbAkPWTdH%2B1jRMdU2wbyA7s8YtxNL4WtkzTONfXDwsReGzR0qJvb17zYGsja6f6S3eqYabY5ySh%2B%2B7wtOYe2Rayj21ZNwampBLbvrDesdwFkOuYMr47g6Egs6klxeMi49NCRFAxncOsqXQdwqGcU1XyZ2C7rcARKm5vD8GR7ptqsK8K%2B1UKZzPcG1z8nEdCXuMtJr%2FGuwGLqbvSmzGiGC5lNidVIzYTLfp%2BbVKqEgmHsFe9MtfAQ8bGXYmA%2FmhURcJTrwpFhHhVHAIM0zkFUYVQYZbUCj4xmzTtwQ9HnnQojl3wVZxie3MRf%2FkNNQRFN7FtaSu617NTnENp5FuR4k7H9kBqa22sYQb5AqNv5qlSN9HhPvVvB6s0YB0ubJdCNOvuVKlOPjaffzc109j6c%2FIJZEN9LEs5mvJ9foDiuW7StUpmqHbE6eWneiSaaf%2BscShutzKD2QuAD5m0YZIwgjbyTZbe47h5ztI9MwmoD89QU67wHvL5MThEViBq8lfZQtyYiMnSNKtAW8KEdcXc49BCy9SsEseVFLABsHN0bi2X5zAgv7gVjqm6sxYjlAj9PuJ23%2BMEVsFUx93PdrDeutaFPrK3tCFDXYcAruAgLlA%2FNu%2BWGUerwNoTK71xW56ZS4N8Ef5YY3MS96bsq2U54V3JoTpgvRzyJICtVSZwzIb8S5honEHFyrsUL2iJkWX%2BKniRSt15tPjI8kSAEt%2BsFPTCe6iOZKG06%2FF6NJL7NTVHp2SIv4vPSz5I1J2MStW96l3UWUYlEkpbuQ7OQaL3I20UNLupyxZ8pBVhfZu8maCFmwmA%3D%3D&X-Amz-SignedHeaders=host&response-expires=2020-05-16T20%3A52%3A21Z&X-Amz-Signature=d3fc1d088e29364850dba23aa39a70dec1f1af5c6e53cde70bc01e5c95f639c9"
}
],
"defects": [
{
"id": "2144386",
"createdAt": "2020-05-15T20:50:46.982Z",
"defectType": "Air Compressor",
"comment": "Comment",
"photos": [
{
"url": "https://samsara-driver-media-upload.s3.us-west-2.amazonaws.com/orgs/53729/drivers/1654973/35ef641a-d155-4c06-aca6-bc55ccc8ce47/B249F7C5-FF55-40CD-ACA4-51E1DB4F75E7.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA3LY3RNWSDJ2QV4X2%2F20200515%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20200515T205221Z&X-Amz-Expires=86400&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEE0aCXVzLXdlc3QtMiJHMEUCIEz8Pg7xeN4UVBn6CL%2BqpjMq75Kfwv59nfkfWscCfaGxAiEA0gIgZCVo3ZOejG9M2JVs6yNaN9SdUx2lhenzBmaZr6Qq4wMIlv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FARACGgw3ODEyMDQ5NDIyNDQiDNrWAS0XJfk3OiHO2Sq3A7ZeZhiVIlAXYqH6Vj6x3j8tXC7%2BCpSVNePptKAA6EyGc9HSZsWiRvTQ0w%2FJigi1JwWPwI1VGmSCrbxjjd3IJ089UqDnl9SssoiRP%2FoMSdhUOpa8HeY7Hjvkr7GaIW%2FWiIh4s9y2mNCvDjObgswxqS6jIu4x7dgt2g78zqcKSxqRx3lcaw3AWBC5H%2Fi4kdyOwi%2BTYIKhPJvUb2yskRgxD27KYjr85PHX8Uk%2BRmUY2%2BhVtkfgAz0GBGvQdPCMgkojyPqqOkve4sggXaZd0YDqXwdiPUcjoIkT47sne55EclJwb%2FuBg8DcG6Vgcf4swJZGnn1q%2FIN%2BdggHf4DkgFCw%2Fbw1HpxwdXhpAs9UZRPmwvs34HfgB6Mh0lyQr7T1NdYPHfDQ8CkjgRZOkDpA%2FnCoD1x%2FiAKhSykDe16LIgcyqm2AhMzyEM8Gk5VC0ChlrBbTj1%2FiktyXto6b0%2BJpcJmuURyHk%2BYqkPkI1g8AP%2F4IqodMBCXQmWSllzzRkgdfvesnjSmWDosMN1YFL9i%2F1MXFaMn0X9KGjrPNicLW6tWhuJ9r%2F7eZzSkEMLZ3jd6rbZt7QOrzdlbcPkAwmoD89QU67wEXnu%2Bgl5EeUpydodC1%2FmZFjbDeESLke4QfApkJWNU7XlQt%2Bfo7SPQtupkkTvZ5XpbnV%2BhoELK0uE3gaILC4R2y3h1yEkylZoqA7F3MvLlkLgqt3rmPq3fPiPWjK663yd7ZmHMwLyjNq5Opg55kBZ8W%2FwlYct%2Fy%2FO6RIiSoZlzOqRRaNBcEFFVozwqYOHbVMo1cz9WofehLKErB78voHxr1CgEspaumZFDIIiPEZR9%2Bm1Ovh7aHrtf3KYYg7TNDm5mBXrJJQcABoh6Hp1WEpGoZdZycFmq5m3Ha8oecKKHp5zhh2KnlkzK8yIAzCZH3bg%3D%3D&X-Amz-SignedHeaders=host&response-expires=2020-05-16T20%3A52%3A21Z&X-Amz-Signature=7aeffa918c0d15893ba1a6cd60add35d3fb315e1f193df247d114c05475e82a2"
}
]
}
]
},
"orgId": 53729,
"resolved": false,
"startMs": 1589575936728,
"summary": "Safe DVIR with defects submitted"
}
}Panic Button Pressed
{
"event": {
"method": "POST",
"path": "/",
"headers": {
"content-length": "858",
"user-agent": "Samsara-Webhook/93bb36bcb206d72d20a3ddfecab547d924bc026e",
"content-type": "application/json",
"date": "Tue, 22 Feb 2022 02:36:12 GMT",
"x-samsara-approximate-retry-count": "0",
"x-samsara-event-type": "Alert",
"x-samsara-payload-source": "Alert",
"x-samsara-request": "a9db46da-7519-4aca-92af-0cb533d5862e",
"x-samsara-signature": "v1=3e806857ffc4a4f6671196ce4c308dacadf401ab6fc907d426144499ee36e66d",
"x-samsara-timestamp": "1645497372",
"x-samsara-version": "2018-01-01",
"accept-encoding": "gzip"
},
"body": {
"eventId": "a9db46da-7519-4aca-92af-0cb533d5862e",
"eventMs": 1645497372713,
"eventType": "Alert",
"orgId": 4001046,
"webhookId": "507188247963909",
"event": {
"alertEventUrl": "https://cloud.samsara.com/o/4001046/alerts/incidents/v2/376311/1/281474978981018/1645497230190",
"alertConditionDescription": "Panic Button",
"alertConditionId": "PanicButtonPressed",
"details": "The panic button has been pressed for vehicle Kenworth #1 at Feb 21 6:33PM PST at Latitude: 30.550612, Longitude: -97.609843, Chad Drive, Round Rock, TX, US.",
"device": {
"id": 281474978981018,
"name": "Kenworth #1",
"serial": "GVJY5T64VC",
"vin": "5J6RW1H55ML006340"
},
"orgId": 4001046,
"resolved": true,
"startMs": 1645497230190,
"summary": "The panic button has been pressed for vehicle Kenworth #1 at Feb 21 6:33PM PST at Latitude: 30.550612, Longitude: -97.609843, Chad Drive, Round Rock, TX, US."
}
}
},
"context": {
"id": "25RkdXpevoK1ODRq70GkN5eiOJt",
"ts": "2022-02-22T02:36:13.011Z",
"pipeline_id": null,
"workflow_id": "p_o7Cwz3V",
"deployment_id": "d_84smVyW",
"source_type": "COMPONENT",
"verified": false,
"hops": null,
"owner_id": "u_LGhOqwL",
"platform_version": "3.20.2",
"workflow_name": "RequestBin",
"resume": null
}Updated 9 months ago
