ScorpionTrack

The ScorpionTrack integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] lets Home Assistant follow the location and speed of vehicles that have been shared through a public ScorpionTrack shared-location link.

This integration is intentionally focused on the share-link workflow. It does not use your private ScorpionTrack account credentials. Instead, it reads the shared vehicle feed exposed by ScorpionTrack and creates location and speed entities from that data. The vehicle location appears on the Home Assistant map.

Prerequisites

Before setting up the integration, you need:

• A valid ScorpionTrack shared-location link
• At least one vehicle included in that share

Create a share link

Create the share in the ScorpionTrack customer portal:

1. Open the ScorpionTrack location share page at app.scorpiontrack.com/customer/locationshare.
2. Create a new shared-location entry.
3. Add every vehicle you want Home Assistant to track.
4. Choose a suitable expiry time for the share.
5. Copy the generated share URL.

You can paste either the full shared-location URL or just the token from that URL.

Configuration

To add the ScorpionTrack hub to your Home Assistant instance, use this My button:

Supported functionality

The ScorpionTrack integration creates one device for each vehicle included in the share. Each device provides:

• A device trackerDevice trackers are used to track the presence, or location, of a device. [Learn more] entity that represents the vehicle on the Home Assistant map and in zone logic, using the latest GPS location reported through the ScorpionTrack share.
• A Speed sensor entity that shows the latest vehicle speed reported through the share.

The tracker name uses the vehicle registration when available, and otherwise falls back to the vehicle name from the ScorpionTrack share.

The Speed sensor initially uses the unit selected for the ScorpionTrack share. You can choose a different display unit in the entity settings.

Data updates

The ScorpionTrack integration pollsData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] ScorpionTrack every 2 minutes for the latest location and speed of each shared vehicle.

Known limitations

• This integration only supports ScorpionTrack shared-location links.
• If the share expires or is revoked, the entities will become unavailable until a valid share is configured again.
• The update speed is limited by the polling interval and by how often ScorpionTrack updates the shared feed itself.

Troubleshooting

The integration says the share is invalid

Make sure the shared-location link is still active in ScorpionTrack and that the token was copied correctly. If you pasted the full URL, verify that it is the actual share URL and not the customer portal page address.

No vehicles appear after setup

Confirm that the ScorpionTrack share still includes vehicles and that the share has not expired. Home Assistant creates tracker entities for vehicles present in the share when the integration is set up or reloaded. If you add vehicles to the share later, reload or reconfigure the integration.

Removing the integration

This integration follows standard integration removal.

To remove an integration instance from Home Assistant

1. Go to Settings > Devices & services and select the integration card.
2. From the list of devices, select the integration instance you want to remove.
3. Next to the entry, select the three dots menu. Then, select Delete.