| Audience | Fleet Admins, Fleet Managers |
| Applies To | Fleet Dashboard |
Introduction
Webhooks are a gateway to receiving valuable information when it happens, rather than continually polling for that data. In the case of multiple events, various URLs have to be specified. Motive will then POST data to those URLs when the events occur.
Follow the link below to find the currently supported actions and their payloads on Webhooks developer documentation:
developer.gomotive.com/reference/introduction#webhooksdeveloper.keeptruckin.com/reference#webhooks
Some of the the common use cases of Webhooks are:
- Vehicle Location Updates: If you want to be notified whenever a vehicle’s current location updates, subscribe to the vehicle_location_updated action.
- Fault Code Opened: If you want to receive a notification any time a new fault code is opened on a vehicle, subscribe to fault_code_opened action.
- Fault Code Closed: If you want to receive a notification whenever an existing fault code is closed on a vehicle, subscribe to fault_code_closed action as it gets triggered whenever an existing fault code is closed on a vehicle.
Steps: Creating Webhooks in Fleet Dashboard
1. Log in to the Motive Fleet Dashboard and go to the Admin tab from the bottom left corner.
2. Go to the Developers tab from the left side menu.
3. Click on Webhooks and then Create Webhook.
4. Fill in all the required information including the following attributes:
- Name: The name for the webhook
- URL: Address that the webhook makes an HTTP Post request to
- Secret: 20 character code to ensure that the request was sent by Motive servers and has been modified in-flight
- Event: Action that you want to get notified about (i.e. HOS Violation)
5. Once the form has been filled, click Save from the top right corner.