Track and manage your Samsung SmartTags and Samsung devices — phones, tablets, watches, and earbuds — directly from Home Assistant using the SmartThings Find service.
🍴 Fork Notice — This is a maintained fork of the original Vedeneb/HA-SmartThings-Find project, which has been archived by its author. A huge thank you to Vedeneb for the original concept, the reverse-engineering work, and the solid foundation this project builds on.
For each registered Samsung device, the integration creates:
| Entity | Description |
|---|---|
device_tracker |
GPS location with accuracy |
sensor |
Battery level (SmartTags only; not supported for earbuds) |
button |
Remotely ring the device |
Notes:
- Physical button presses on a SmartTag are not supported. Other integrations can handle that.
- Stopping a ring is not yet implemented (the SmartThings Find website API has limited support for this).
Click the button below to add this repository directly to HACS, or manually add https://github.com/mariosemes/HA-SmartThings-Find as a custom integration repository.
- Search for SmartThings Find in HACS and install
- Restart Home Assistant
- Follow the Setup steps below
- Copy the
custom_components/smartthings_finddirectory into your HA configuration directory - Restart Home Assistant
- Follow the Setup steps below
Or go to Settings → Devices & Services → Add Integration and search for SmartThings Find (do not confuse with the built-in SmartThings integration).
Steps:
- Click the login link shown in the setup form — Samsung's login page will open in your browser
- Sign in with your Samsung account
- Once redirected to SmartThings Find, press F12 to open DevTools
- Go to Application → Cookies →
https://smartthingsfind.samsung.com - Copy the value of the
JSESSIONIDcookie and paste it into the setup form - The integration validates the session and completes setup automatically
The integration uses Samsung's OAuth2 login flow. The JSESSIONID cookie is a one-time setup step — no credentials are stored.
The setup wizard records when the session was created so you can track its age under: Settings → Devices & Services → SmartThings Find → Download Diagnostics
Community experience suggests sessions last at least several weeks, though Samsung does not officially document the expiry. When a session expires, Home Assistant will show a persistent notification — clicking it lets you paste a fresh JSESSIONID in under a minute, with no reinstall needed.
| Mode | Behaviour | Battery impact |
|---|---|---|
| Active | Sends a location update request to the device before fetching | Higher |
| Passive | Fetches the last known location already stored in STF | Lower |
Defaults: Active mode is on for SmartTags, off for all other devices.
You can toggle per device type and adjust the update interval (default: 120 seconds) under Settings → Devices & Services → SmartThings Find → Configure.
Ringing a SmartTag requires a Galaxy phone/tablet nearby to relay the command over Bluetooth. Without a nearby device, the ring request will silently fail — the location will still update if any Galaxy device is in range.
If ringing does not work from Home Assistant, test it on the SmartThings Find website first. If it does not work there either, it is a network/proximity issue, not an integration bug. Note that the SmartThings mobile app uses a different backend than the website — always test on the website.
Add the following to configuration.yaml to enable debug logging:
logger:
default: info
logs:
custom_components.smartthings_find: debugOn each startup, the log will include the current session age:
Session age: 12d 3h (authenticated at 2026-02-13 08:51 UTC)
- Unofficial API — built by reverse-engineering the SmartThings Find web service. It may stop working if Samsung changes their backend.
- Limited testing — if you encounter issues, please open an issue.
- This project is not affiliated with or endorsed by Samsung or SmartThings.
- HACS support
- Multiple Samsung accounts (multiple config entries)
- Session age tracking via diagnostics
- Service call to ring a device
- Service call to stop ringing (for devices that support it)
Contributions are welcome — feel free to open issues or submit pull requests. See CHANGELOG.md for recent changes.
MIT — see LICENSE for details.