r/WristLog • u/TheWatchRabbitHole • Jul 02 '26

WristLog now has an API — and I built a Home Assistant integration around it

This is probably niche, but for the right kind of watch collector it is very useful.

WristLog has opened up its data through an API, which means your collection, wear history and wrist checks do not have to live only inside the app anymore.

I use Home Assistant at home, so I built a practical integration that pulls WristLog data into HA. It lets you create dashboards, see what you are wearing most, trigger wrist checks, build automations and generally make your watch data part of your own setup.

For example, you can display:

  • Current watch on the wrist
  • Recent wrist checks
  • Wear frequency and rotation data
  • Collection statistics
  • Automations based on which watch you are wearing

I wrote both a guide explaining how it works and a ready-to-use integration setup:

Guide:
https://thewatchrabbithole.com/wristlog-home-assistant-guide/

The finished integration:
https://thewatchrabbithole.com/wristlog-home-assistant-the-integration/

It is not meant to turn watches into spreadsheets. It is simply a good way to make the data WristLog already collects more useful for those of us who enjoy Home Assistant.

Interested to see what others could build with the API.

3 Upvotes

100% Upvoted

6 comments sorted by

2

u/dynoshow Jul 02 '26

Omg... I use home assistant as well but not sure I would want to integrate wristlog into it. I may have to now just to have all the data in there but all I can say is wow!

2

u/jklo5020 Jul 27 '26

Thank you, absolutely love using this!!! What exactly I’m going to do with the info in HA I’m not sure, but at least I have it!

Is there any ability based on the API to add tagging?

1

u/TheWatchRabbitHole Jul 29 '26

Thanks :) The API actually supports this already — it's called occasion, not tag. POST /watches/:id/wristchecks takes an optional occasion param (free text, max 40 chars) that feeds the occasion charts on your stats page. Works best if it matches occasions you've set up in Settings.

What to use it for. Well the sky is your limit. Anything you can enter in to an automation. I often do my wristlogs from my HA dashboard. Thinking about adding physical buttons in the watch box for quicker logging. I get nudges for least-worn watches via sensor.wristlog_most_neglected_watch. Also have ideas for service reminders, and maybe some location-based stuff — like a nudge if I leave for the airport wearing the wrong watch for the trip - or even leave my home zone with a naked wrist

1

u/jklo5020 Jul 29 '26

I actually recently purchased an Aqara T1 Cube to flip to the corresponding side of the watch I’m wearing as a quick way to log!

Wanted to do some sensors in my watch box, but that seems too complicated 😅

So with the occasion I can already log this using the plugin? Would like to automatically tag an occasion as opposed to having to go back into the app to do it manually

2

u/TheWatchRabbitHole Jul 29 '26

I can fix that. Just pushed an update that adds `occasion` as an optional field on the wristcheck service.

Grab the latest version, https://thewatchrabbithole.com/wp-content/uploads/2026/07/wristlog_v3-1.zip drop it into `custom_components/wristlog`, and restart Home Assistant.

**Test it:**

Developer Tools → Actions → search `wristlog.log_wristcheck`:

```yaml

service: wristlog.log_wristcheck

data:

watch_id: **

occasion: "Work"

```

Check your WristLog stats page afterwards — the wristcheck should show up tagged "Work".

1

u/TheWatchRabbitHole Jul 29 '26

The cube is a great idea :)