Trackunit Webhook Event Types
This is the list of event types that we currently send.
alerts.asset.off
Event triggered upon resolution of an asset alert
Example
JSON
{
"accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
"assetId": "eeba6427-3c44-4691-8e74-446403db8867",
"data": {
"alertConfigurationId": "15dedb88-57a1-4aa7-9237-e976f15af116",
"name": "My Movement Alert"
},
"eventId": "a9c01033-83a6-4d53-851d-8d2dcc6b1421",
"eventTime": "2023-10-10T13:25:03.321Z",
"eventType": "alerts.asset.off"
}alerts.asset.on
Event triggered upon detection of an asset alert
Example
JSON
{
"accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
"assetId": "eeba6427-3c44-4691-8e74-446403db8867",
"data": {
"alertConfigurationId": "15dedb88-57a1-4aa7-9237-e976f15af116",
"name": "My Movement Alert"
},
"eventId": "a9c01033-83a6-4d53-851d-8d2dcc6b1421",
"eventTime": "2023-10-09T15:31:05.843Z",
"eventType": "alerts.asset.on"
}data-feeds.asset.management.beta
Event triggered upon asset selection updates
Example
JSON
{
"accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
"assetId": "eeba6427-3c44-4691-8e74-446403db8867",
"data": {
"assetId": "eeba6427-3c44-4691-8e74-446403db8867",
"integrationId": "e62824ba-6e60-48cf-b4d1-07204fe9bb54",
"selected": true
},
"eventId": "eeba6427-3c44-4691-8e74-446403db8867",
"eventTime": "2021-08-31T10:00:00Z",
"eventType": "data-feeds.asset.selection-updated"
}faults.asset.off
Event triggered upon resolution of an asset fault
Example
JSON
{
"accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
"assetId": "eeba6427-3c44-4691-8e74-446403db8867",
"data": {
"description": "Exhaust Emission Control - Generator Average Line-Neutral AC RMS Voltage - Data Valid But Above Normal Operating Range - Least Severe Level",
"j1939": {
"fmi": 15,
"sa": 44,
"spn": 2444
},
"severity": 35
},
"eventId": "a9c01033-83a6-4d53-851d-8d2dcc6b1421",
"eventTime": "2023-10-10T13:25:03.321Z",
"eventType": "faults.asset.off"
}faults.asset.on
Event triggered upon detection of an asset fault
Example
JSON
{
"accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
"assetId": "eeba6427-3c44-4691-8e74-446403db8867",
"data": {
"description": "Exhaust Emission Control - Generator Average Line-Neutral AC RMS Voltage - Data Valid But Above Normal Operating Range - Least Severe Level",
"j1939": {
"fmi": 15,
"sa": 44,
"spn": 2444
},
"severity": 35
},
"eventId": "a9c01033-83a6-4d53-851d-8d2dcc6b1421",
"eventTime": "2023-10-10T13:25:03.321Z",
"eventType": "faults.asset.on"
}fleet-data-health.asset.issues
Fleet Data Health Issues detected of an asset
Example
JSON
{
"accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
"assetId": "eeba6427-3c44-4691-8e74-446403db8867",
"data": {
"category": "OPERATIONAL_DEVICE_CORE_DEFINITION",
"issueId": "e294ad3a-acc1-477c-889e-08d927296fd5",
"issueType": "LOW_BATTERY_POWER",
"resolvedAt": null,
"state": "OPEN"
},
"eventId": "a9c01033-83a6-4d53-851d-8d2dcc6b1421",
"eventTime": "2023-10-10T13:25:03.321Z",
"eventType": "fleet-data-health.asset.issues"
}inspection.inspection-response.submitted
Event triggered upon InspectionResponse being submitted
Example
JSON
{
"accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
"assetId": "eeba6427-3c44-4691-8e74-446403db8867",
"data": {
"answers": [
{
"answer": "string",
"id": "9306fd52-c2ce-43e7-b3bd-9da594b9e23c",
"imageReferences": [
{
"id": "da91470f-b303-44db-99b5-d36da6357a4d",
"imageId": "5a5e666e-7ed4-4fd4-a4d5-c38c7ef549e7",
"imageUrl": "https://images.iris.trackunit.com/eyJrZXkiOiI1YTVlNjY2ZS03ZWQ0LTRmZDQtYTRkNS1jMzhjN2VmNTQ5ZTcifQ=="
},
{
"id": "2cfd348d-be3e-47ee-afe5-69e418f30ea3",
"imageId": "aad6915c-d35e-4b4f-8f55-979bc0233b7d",
"imageUrl": "https://images.iris.trackunit.com/eyJrZXkiOiJhYWQ2OTE1Yy1kMzVlLTRiNGYtOGY1NS05NzliYzAyMzNiN2QifQ=="
}
],
"questionId": "4a831aef-283a-4c44-aff6-e8884f9e5c5e",
"type": "string"
}
],
"inspectionResponseId": "a8b7d20c-1093-4f20-9a41-defea6e5c6c4",
"inspectionTemplateVersionId": "3e236c79-bc7f-4a43-bac6-ed987b16d0b6",
"inspectionTime": "2023-10-10T13:25:03.321Z",
"location": {
"latitude": 39.564569,
"longitude": 2.6542945
},
"operatorId": "1e605626-c6c2-483c-9496-933c727e6f16",
"status": "PASSED"
},
"eventId": "a9c01033-83a6-4d53-851d-8d2dcc6b1421",
"eventTime": "2023-10-10T13:25:03.321Z",
"eventType": "inspection.inspection-response.submitted"
}rental.asset.updated.beta
Event triggered upon rental status updates
Example
JSON
{
"accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
"assetId": "eeba6427-3c44-4691-8e74-446403db8867",
"data": {
"contractItems": {
"contract": {
"customerId": "123e4567-e89b-12d3-a456-426614174000",
"endDate": "2021-08-31T23:59:59Z",
"externalReference": "605P1600003",
"startDate": "2021-08-01T00:00:00Z",
"status": "CANCELLED"
},
"deliveryAddress": {
"address": "123 Main St.",
"city": "Springfield",
"country": "United States of America",
"postalCode": "60031"
},
"externalReference": "123654",
"offRentDate": "2021-09-30T10:00:00Z",
"onRentDate": "2021-08-31T10:00:00Z",
"pickupAddress": {
"address": "123 Main St.",
"city": "Springfield",
"country": "United States of America",
"postalCode": "60031"
},
"rentalRate": {
"currency": "GBP",
"interval": "WEEKLY_5_DAYS",
"unitPrice": 100
},
"scheduledDeliveryDate": "2021-08-31T10:00:00Z",
"scheduledPickupDate": "2021-09-30T10:00:00Z"
},
"rentalStatus": "ON_RENT"
},
"eventId": "eeba6427-3c44-4691-8e74-446403db8867",
"eventTime": "2021-08-31T10:00:00Z",
"eventType": "rental.asset.updated.beta"
}service-management.service-status.updated
Event triggered upon service status updates
Example
JSON
{
"accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
"assetId": "eeba6427-3c44-4691-8e74-446403db8867",
"data": {
"cumulativeOperatingHoursCriteria": {
"criteria": {
"id": "6037a205-927c-4937-8b05-602c4f677929",
"notifyHoursBefore": 75,
"serviceHours": 700
},
"triggered": false
},
"distanceCriteria": {
"criteria": {
"id": "6037a205-927c-4937-8b05-602c4f677929",
"notifyDistanceBefore": 50,
"serviceDistance": 500
},
"triggered": true
},
"name": "Regular Service",
"plannedServiceId": "e62824ba-6e60-48cf-b4d1-07204fe9bb54",
"predictedAt": "2021-09-20T06:09:09.621736Z",
"predictedServiceTime": "2021-09-20T06:09:09.621736Z",
"predictionCriteria": "CUMULATIVE_OPERATING_HOURS",
"servicePlanId": "eeba6427-3c44-4691-8e74-446403db8867",
"serviceProviderAccountId": "e62824ba-6e60-48cf-b4d1-07204fe9ab56",
"status": "OVERDUE",
"timeCriteria": {
"criteria": {
"notifyDaysBefore": 50,
"serviceTime": "2021-09-25T12:14:03.321736Z"
},
"triggered": false
},
"triggeredAt": "2021-09-20T06:09:09.621736Z"
},
"eventId": "eeba6427-3c44-4691-8e74-446403db8867",
"eventTime": "2023-11-30T05:44:16.081Z",
"eventType": "service-management.service-updated"
}sites.asset.archive
Event triggered upon an asset no longer being tracked on a site
Example
JSON
{
"accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
"assetId": "eeba6427-3c44-4691-8e74-446403db8867",
"data": {
"reason": "View permission was revoked",
"siteId": "967679e8-ccf0-48b2-a2a4-c3595576c583"
},
"eventId": "a9c01033-83a6-4d53-851d-8d2dcc6b1421",
"eventTime": "2023-12-15T15:10:53.123Z",
"eventType": "sites.asset.archive"
}sites.asset.enter
Event triggered upon an asset entering a site
Example
JSON
{
"accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
"assetId": "eeba6427-3c44-4691-8e74-446403db8867",
"data": {
"reason": "Asset location updated",
"siteId": "967679e8-ccf0-48b2-a2a4-c3595576c583"
},
"eventId": "a9c01033-83a6-4d53-851d-8d2dcc6b1421",
"eventTime": "2023-10-10T13:25:03.321Z",
"eventType": "sites.asset.enter"
}sites.asset.leave
Event triggered upon an asset leaving a site
Example
JSON
{
"accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
"assetId": "eeba6427-3c44-4691-8e74-446403db8867",
"data": {
"reason": "Asset location updated",
"siteId": "967679e8-ccf0-48b2-a2a4-c3595576c583"
},
"eventId": "a9c01033-83a6-4d53-851d-8d2dcc6b1421",
"eventTime": "2023-11-10T23:20:15.232Z",
"eventType": "sites.asset.leave"
}trip.has.ended
Event triggered upon an detected completed trip
Example
JSON
{
"accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
"assetId": "eeba6427-3c44-4691-8e74-446403db8867",
"data": {
"cumulativeMovingHours": 0.25,
"distanceTravelled": 2.56,
"endDataPoint": {
"latitude": 44.318331666666666,
"longitude": 12.22364,
"speed": 1.5,
"timestamp": 1728479925493
},
"startDataPoint": {
"latitude": 44.318331666666666,
"longitude": 12.22364,
"speed": 4.5,
"timestamp": 1728479454716
},
"topSpeed": 16,
"tripId": "9b4db9e0-2ad6-49ea-ac1d-523673f46bdd"
},
"eventId": "a9c01033-83a6-4d53-851d-8d2dcc6b1421",
"eventTime": "2024-10-10T13:25:03.321Z",
"eventType": "trip.has.ended"
}