Toggl Track Integration

Connect your Toggl Track account to send Sunsama time tracking data to Toggl Track.

Walkthrough

Installation and account management

Setup instructions:

In Sunsama, navigate to Settings > Integrations > Toggl Track
Click “Add Toggl Track account”
Paste your Toggl Track API token (found at the bottom of your Toggl Track profile page)
Click “Add account”

Toggl Track API token setup

Settings and synced fields

Configure your Toggl Track integration settings page to control what is synced from Sunsama to Toggl Track, and how it is logged there.

Toggl Track settings

Track everything in Toggl Track by default

Turn on this setting if you want all tasks, regardless of what channel they are assigned to, to be tracked in Toggl Track. This is a good option if you want to just generally start seeing your actual time analytics across the board.

If you enable this setting and sync and configure specific channels to Toggl Track, this setting will be used like a fallback default for all other tasks.

Synchronized channels

Configure synchronized channels to sync timer data from specific Sunsama channels to Toggl Track. This is useful for both categorizing your timer entries in Toggl Track automatically, and also controlling what is synced (for example so you do not sync your personal tasks to Toggl Track).

Click “Add new channel to sync to Toggl Track” to configure the synchronization. First, select which channel or context to sync, then select:

Which Toggl Track workspace to sync to (if applicable)
Which project to sync the Sunsama channel to
Which task within that project to assign timer entries to — useful if your Toggl Track workspace uses pre-defined tasks (e.g. “Admin”, “Software Dev”) that must be set on every time entry. This requires a Toggl Track Starter plan or higher.
Which Toggl Track tags to tag the timer entries with
Whether or not to log these timer entries as billable or non-billable (this feature is not available for free-tier Toggl Track accounts)

How to sync time tracking to Toggl Track

Now that your Toggl Track account is connected, actual time on your tasks in Sunsama can be automatically logged as time entries on your timer page in Toggl Track. The time entry will display in both Toggl Track’s timer list view as an entry, and on the calendar view.

It’s important to know that the actual time field on a Sunsama task is not “synced” to Toggl Track, but rather timer entries in Toggl Track are triggered by the following actions in Sunsama:

Via task timer

When you start a task timer in Sunsama, a timer will start in Toggl Track. When you stop the task timer in Sunsama, the timer will stop in Toggl Track and the time entry will be logged.

If you start and stop the timer multiple times on the same task in Sunsama, multiple timer entries will be logged in Toggl Track, but they will all be collated under the same task in Toggl Track.

In the calendar view in Toggl Track, the time entry will show as an event during the time the timer runs.

Via task completion

Timer entries will also be created when you complete a task with actual time in Sunsama. Here is a breakdown of some specific use cases:

If the task has no actual time (you did not run the task timer and did not manually input actual time), and you have “Count planned time as actual time” enabled, an entry for the planned/actual time of the task will be logged in Toggl Track when you complete the task.
If you manually log actual time on the task (not via the task timer), an entry for the actual time of the task will be logged in Toggl Track when you complete the task.
If an imported calendar event is auto-completed at its scheduled end time, a timer entry will be logged in Toggl Track.

When creating a Toggl Track time entry via task completion, the time entry will show on the Toggl Track calendar wherein the end time is the time of completion and the start time is the actual time of the task earlier than the time of completion. For example, if you completed a task with an actual time of 45 minutes in Sunsama at 9:45AM, the calendar entry in Toggl would show from 9:00AM to 9:45AM.

Subtask behavior

Timer entries for subtasks will be logged such that the name of the timer entry will show as the main task name followed by the subtask name.

When you mark a subtask complete and it has actual time, a timer entry will be created.
When you run the task timer on a subtask, a timer entry will be created.
If a subtask has manually entered actual time, and is completed via completing the parent task, timer entries for the subtask(s) will be created.

However, if a subtask does not have actual time when it is completed, no entry for the subtask will be created in Toggl Track and just the parent task will be logged.

Troubleshooting

Note: only the task timer and task completion trigger timer entries in Toggl Track, so not all scenarios will trigger timer entries or sync actual time in Toggl Track. Examples include: importing an event that has already passed, or completing a task and then changing the actual time in Sunsama. In such situations, we recommend manually inputting or editing a timer entry in Toggl Track for accuracy.

Using Toggl Track for time analytics

Watch this video for a basic overview of using Toggl Track to capture and report your time analytics: