Use cases · Widgets
Your number, on your Lock Screen.
Set a metric such as MRR, signups or queue length with one request, and Hook's widget shows the latest value.
- Value is a number or a string up to 24 characters
- Works with your workspace URL, no token needed
- Also: set the app icon badge with POST /api/badge

Set it up in a minute. Three steps.
- Step 1
Pick a key
Any key such as mrr. A new key creates the metric.
- Step 2
PUT the value
Send it from a cron job, a CI step or your backend, with a token or your workspace URL.
- Step 3
Add the widget
Add Hook's widget to your Lock Screen or Home Screen and choose the metric.
terminal
curl -X PUT https://gethook.app/workspace/{workspace_key}/metric/mrr -d '{"value":1240,"label":"MRR","unit":"$"}'Replace {workspace_key} with the key shown in the app. Fields like title and priority are explained in Publishing messages.
What people ask before they set it up.
How often can I update it?
Up to 120 live and metric calls a minute per user. iOS decides when a widget redraws.
