Linking to Sunsama
Open the Sunsama desktop and mobile apps from links in your own notes, docs, and tools.
Sunsama registers a sunsama:// link scheme, so a link in a note, a doc, a dashboard, or another app can open Sunsama directly instead of a browser tab.
| Link | What it does |
|---|---|
sunsama:// |
Opens Sunsama, or brings it to the front if it’s already running. |
sunsama://today |
Opens Sunsama on today. |
sunsama://action/details/<task id> |
Opens a specific task. |
The same links work in the desktop app on Mac and Windows and in the iOS and Android apps. On mobile, sunsama://today opens the app wherever you last left it.
Linking to a task
To get a task’s link, open the task, click the ⋯ menu, and choose Copy link. You’ll get a web link like this:
https://app.sunsama.com/group/your-workspace/?taid=66845f446204c9e689ecba7bThat link works anywhere, and on your phone it opens the Sunsama app when it’s installed. To open the task in the desktop app instead, take the ID after taid= and use it in a sunsama:// link:
sunsama://action/details/66845f446204c9e689ecba7bLinux
On Linux, the desktop app ships as an AppImage, which doesn’t register link schemes by itself. To make sunsama:// links open the app, install it with a tool that integrates AppImages into your desktop, like AppImageLauncher.