Webhooks

Webhooks are automated messages that get sent over HTTP when a certain condition is met. Using webhooks allows you to automate processes and receive notifications automatically, without having to check manually.

What can you use webhooks for?

You can subscribe devices via the Add a webhook subscription request to a partner's hosted webhook destination URL.

After configuring a webhook destination URL, a subscription becomes active, and the Gowit API sends messages containing GPS, driver, and vehicle metadata in real-time to the webhook destination URL.

Example webhook data:

{
  "date": "2024-05-09",
  "time": "16:49:18",
  "driver":{
    "id": "23421",  // Will be empty ("") when the driver is not checked in
    "name": "firstName lastName"  // Will be empty ("") when the driver is not checked in
  },
  "vehicleInformation": {
    "id": "357336345",
    "name": "truck"
  },
  "carrierId": "4601",
  "location": {
    "lat": 21.62193461,
    "lng": -83.6978393
  },
  "dutyStatus": "online" // offline, online, standby
}