Geotab Integration

About the Geotab Integration

Geotab is a Blackout Fleet partner. It uses a server-to-server integration to block drivers during trips to reduce distractions from their smartphones. Drivers and Vehicles are syncronised across platforms. Geotab's driver associations are used to determine who is driving and block them in near-real-time.

Visit Geotab

Frequently asked questions

What does the Geotab integration actually do?

Blackout connects to your MyGeotab database and imports your vehicles, drivers and admins. It then reads each vehicle’s GPS and ignition data from Geotab every 30 seconds to work out when a trip starts and ends, and who is driving. While a trip is in progress, the driver’s phone is limited to all but the most basic features by the Blackout app, helping to create a distraction-free environment. A Blackout add-in lets you monitor your fleet from inside MyGeotab.

What do I need before I can turn it on?

Blackout will first set up an organisation for you. An administrator then connects Geotab from the Blackout dashboard by entering your MyGeotab server, database name, and the username and password of the account Blackout should use. We recommend creating a dedicated MyGeotab account for Blackout that can see the vehicles and drivers you want covered.

What access does Blackout need to our Geotab account?

Blackout needs a MyGeotab account that can read your vehicles, drivers and groups, along with the vehicles’ GPS, ignition and driver log-in data. We recommend a dedicated account rather than a personal admin login. Its credentials are encrypted and held in AWS’s managed secrets storage. Blackout only reads from your database: it doesn’t create rules, notifications or webhooks.

What does Blackout create inside my MyGeotab account?

Nothing, apart from the Blackout add-in itself if you choose to install it. When the add-in is first set up, it saves one small setting in your database recording which region your fleet’s Blackout data is hosted in.

Is anything written back into Geotab after setup?

No. Blackout only reads from Geotab. The only thing it stores in your database is the add-in’s hosting-region setting.

How often does data sync?

Vehicles, drivers and admins are synchronised every night at 03:00 UTC, and an administrator can run a sync from the dashboard at any time. Trip detection runs separately, checking each vehicle’s latest Geotab data every 30 seconds.

Which records are imported?

Vehicles (with their Geotab device ID, and number plate where set), drivers, and Geotab admins, who become Blackout administrators.

Are imported drivers/admins emailed?

By default no — accounts are created silently. Invitations are opt-in via the manual import UI.

Can I trigger a sync manually?

Yes. Use the re-sync button on the Geotab integration page in the Blackout dashboard. It re-imports vehicles, drivers and admins.

How does Blackout know who is driving the vehicle?

Blackout uses the driver Geotab has logged in to the vehicle, for example through a driver ID key or tag, or the Geotab Drive app, and matches them to the Blackout account created when drivers were imported. Only that driver’s phone is blocked. If a driver logs in after the trip has started, the trip passes to them; if a different driver logs in mid-trip, a new trip starts for the new driver.

We've added a new driver or vehicle in Geotab. When will blocking start working for them?

New drivers and vehicles are picked up by the overnight synchronisation, so they will appear in Blackout the following day. A new driver will also need the Blackout app installed and set up on their phone before blocking can take effect — if automatic invites are enabled for your organisation, they’ll receive an invite email once the sync has run. If you need someone up and running sooner, an administrator can trigger a manual sync.

Why does it take some time to block or unblock my device?

Blackout checks each vehicle’s Geotab data every 30 seconds. A trip starts once the vehicle has been moving above walking pace for a short time, so the block usually arrives within a minute of setting off. A trip ends as soon as Geotab reports the ignition off, or after the vehicle has been stationary for 3 minutes. Longer delays usually come down to mobile signal: the Geotab device has to reach Geotab’s servers, and the driver’s phone needs a data connection to receive the change.

My phone sometimes takes several minutes to unblock. What is happening?

Some vehicles switch the Geotab device’s modem off soon after the ignition goes off, before it has sent its final data. If Blackout hears nothing from a vehicle for 5 minutes during a trip, it releases the driver’s block automatically, so a driver shouldn’t stay blocked for longer than that. You can make this less likely by extending how long the Geotab device stays awake before sleeping, in the device’s settings in MyGeotab.

What happens if the driver's phone has no signal when a trip starts?

The block is delivered to the phone over the internet, so the phone needs a data connection to receive it. If the phone has no signal when the trip starts, it will remain unblocked until it reconnects, at which point it checks in with Blackout’s servers and applies the correct state. The same applies in reverse — if a trip ends while the phone is offline, it will unblock once it reconnects.

What about passengers? Does everyone in the vehicle get blocked?

No. Only the phone of the person Geotab identifies as the driver of the vehicle is put into restricted mode. Passengers’ phones are unaffected, including other Blackout users travelling as passengers — their phones are only blocked when they are the identified driver of a vehicle on a trip.

Can drivers still make emergency calls while their phone is blocked?

Yes. On both Android and iOS, phone calls are allowed.

What can I see in the Blackout dashboard inside MyGeotab?

The Blackout add-in gives you a summary of your fleet without leaving MyGeotab: headline figures (registered devices, devices currently blocked, devices with Blackout disabled, vehicles and trips this month), charts of device statuses and flagged events, and tables of recent trips, devices, vehicles and users. Each row links through to the full Blackout dashboard, which is where actions such as inviting drivers and managing settings take place — the add-in itself is a read-only view.

What do the device statuses in the dashboard mean?
  • Compliant: the phone is set up and working normally.
  • Quiet: the phone hasn’t checked in recently, but for less than 24 hours.
  • Disabled by User: the driver has turned Blackout off in the app.
  • Needs Permission Fix: a permission Blackout needs has been turned off on the phone.
  • Out of Contact: the phone hasn’t checked in for over 24 hours. It may be off, flat or without signal.
  • Likely Uninstalled: the app looks like it has been removed from the phone.
  • Added / Invited / Incomplete: the driver has been added, has been sent an invite, or started setting up the app but didn’t finish.
Why can't I see a vehicle or driver in the add-in?

There are three common reasons. First, the add-in only shows the vehicles and drivers your own MyGeotab user has permission to see. If your permissions have recently changed, use the Refresh permissions button. Second, newly added vehicles and drivers appear after the overnight sync, or after a manual sync. Third, a driver’s Geotab login must match the email address on their Blackout account.

Do I need to log in to Blackout separately to use the add-in?

No. The add-in uses your existing MyGeotab session — there’s no separate password or API key. Blackout verifies the session with Geotab and matches your MyGeotab username to a Blackout administrator account. If you see a message saying you don’t have permission, it means your MyGeotab username doesn’t match an administrator email on your organisation’s Blackout account — contact us and we’ll get it matched up.

Where is our fleet's data hosted, and can we change the region?

When the add-in is first set up you choose where your fleet’s data is hosted: UK/Europe or US/Canada. All of your organisation’s Blackout data is then held in that region. The choice applies to your whole fleet and is permanent — it can’t be changed later, so if you’re unsure which region is right for you, contact support before completing setup.

A vehicle didn't appear in Blackout

Vehicles are matched by their Geotab device ID, so a vehicle without one is skipped. Only enrolled vehicles are imported, so check the vehicle is enrolled for Blackout in MyGeotab. New vehicles appear after the overnight sync, or after a manual sync.

A driver didn't appear

Only Geotab users marked as drivers are imported, and if your integration is limited to certain Geotab groups, only drivers in those groups. A driver’s Geotab login is used as their Blackout email address, so it needs to be a valid email address.

I'm getting an authentication / 403 error in the Add-On

A permission (403) message means your MyGeotab username doesn’t match an administrator email on your organisation’s Blackout account. Contact us and we’ll match it up. An authentication message usually means your MyGeotab session has expired: log out of MyGeotab and back in.

Trips aren't showing up

Check that the vehicle exists in Blackout (it appears after a sync), and that a driver is logged in to the vehicle in Geotab and has been imported into Blackout, because trips without an identified driver aren’t kept. Also check that the MyGeotab account Blackout uses still works. If its password has been changed or the account disabled, Blackout can no longer read your fleet’s data.

A trip was recorded but the driver's phone was never blocked

Check the driver’s device status in the dashboard. The app may not be set up, or the phone may have Blackout disabled, be missing a permission, or have had no signal. If no driver was logged in to the vehicle in Geotab, or the driver hasn’t been imported into Blackout yet, no phone is blocked and the trip isn’t kept.

We rotated the MyGeotab password

If you change the password of the MyGeotab account Blackout uses, Blackout can no longer read your fleet’s data and trips stop being detected. Disconnect the integration in the Blackout dashboard and Connect again with the new password. If you are still having difficulties, please contact us.

Can the integration be removed?

Yes. An administrator can disconnect Geotab from the integration page in the Blackout dashboard, and choose whether to also remove the imported vehicles and drivers. Nothing in MyGeotab needs tidying up beyond uninstalling the Blackout add-in and, if you created one, deleting the account you set up for Blackout.

We were set up on the older Geotab integration. Do we need to do anything?

No. Blackout moves existing fleets to the current integration for you. As part of the move, the trip rules, distribution list and web request the older integration created in your MyGeotab database are removed. The service account it created is kept, because Blackout uses it to read your fleet’s data.