How to create Webhooks in Fleet Dashboard

    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 (formerly Keeptruckin) 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.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.

    1.jpg

    2. Go to the Developers tab from the left side menu.

    2.jpg

    3. Click on Webhooks and then Create Webhook.

    3.jpg

    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)

    4.jpg

    5. Once the form has been filled, click Save from the top right corner.

    5.jpg

     

    Related Content

    Share this with others