Geotab

Updated by Dean Perry

Geotab offers state-of-the-art vehicle tracking that’s accurate, powerful, and easy to use. Geotab can be used to track the location of an asset and get odometer readings.

ToolHound can connect to your Geotab account to retrieve coordinates for any serialized inventory item with a Geotab tracking device. The device serial number must be entered as an Item ID, primary or alternate, in ToolHound for the associated item.

ToolHound Configuration

  1. An API Secret is generated when first entering the page. Use the Refresh button to the right to generate a new secret. This value is required when configuring the Geotab Web Request Template.
  2. If you wish to update service odometer readings from Geotab, check Update Service Reading?
    1. Choose the ToolHound user to associate with the meter reading. You could create a new mobile only user specifically for this purpose if you wish.
    2. Choose the meter that matches the Geotab odometer reading meter (Example: km or miles). There is one for metric and imperial meters. If the meter is not available in ToolHound, create a new meter first.
  3. Save the changes.

Geotab Configuration

Add a Web Request Template
  1. In MyGeotab, navigate to Rules & Groups > Notification Templates.
  2. click on the "Add Web Template" tab.
  3. Enter a Template name. Remember this for later.
  4. Enter the public URL of your deployed ToolHound endpoint.
    Example: https://www.mytoolhound.com/webhook/geotab/tripcompletion/company
    where company is your ToolHound company used at log in.
  5. Select POST as the HTTP request type.
  6. Enter the following for POST data.
    eventName={Rule}&UnitNumber={Device name}&SerialNumber={Serial number}&vehicle={Device}&vin={Vin}&datetime={Date} {Time}&address={Address}&latitude={Latitude}&longitude={Longitude}&speed={Speed}&odometer={Odometer}&ruleId={Exception Id}&apisecret=12345678
    Replace 12345678 with the API Secret generated in ToolHound in step 1 to verify that this is a valid transaction. Use copy and paste from ToolHound to ensure you have the correct value.
  7. Save the template.
Define the Trip Completion Rule
  1. In MyGeotab, go to Rules & Add-Ins > Rules.
  2. Create a new rule (or modify an existing one).
  3. Condition: Use conditions that accurately define a trip completion. A common approach is:
    1. Driving state = True (for a minimum duration, e.g., 1 minute)
    2. AND then Driving state = False (for a minimum duration, e.g., 5 minutes)
    3. You might also add a Device total distance condition to ensure it's not just a short maneuver.
    4. Simpler: Use the built-in "Trip" rule (if available and suits your needs) as a base.
  4. Navigate to the Notifications section
  5. Select "More…" and then choose the web request template you created.
  6. Save the rule.

At any time you can disconnect Geotab to stop sharing meter readings and GPS data with your ToolHound database by deleting the rule created above.

For On Premise installations, the server must have a public URL or IP address to accept the updates.

See also:

​Copyright © 2020-2025 ToolHound Inc. All Rights Reserved.

How did we do?