Integration with your Clockify Projects

To add your Clockify profile, first you have to open the Settings > Profile tab in Whid. Then click on the “Add Profile” button, set a name for your profile (e.g. “Clockify” or “My Clockify”) and select “Clockify” from the target system selector.

To fill the Workspace ID field, go to the Workspace settings in Clockify. You can get there via the three dots next to your workspace name in the top left corner. Here, you can copy the Workspace ID from the URL.

You also need your Project ID. For this, click on Projects in the left sidebar, then select your desired project. You can find the ID in the URL.

Next, you need to create an API key. For this, hover over your user in the top right corner and select preferences.

Then go to Advanced and click on generate in the API key section and copy the key to Whid.

The last thing to set is whether your tasks should be entered as billable. Enabling it sets all tasks for this profile to billable.

Now you can save your credentials.

Whid validates your credentials on Save. If you are not connected to the internet while saving, you can choose the “Save without validation” option, but Whid will always need access when you sync your tracked times to Clockify.

In Clockify you can sync your booked times to tasks. These synced times will appear as time entries. To make your sync even easier, you can set up automatic mappings between your tracked tasks and Clockify tasks.

You can open the Settings > Sync Mappings tab in Whid.

Add a new entry in the “Auto Extraction for Sync Mappings” section: select your Clockify profile from the dropdown, and set the “Regex Pattern” to something like: ID-([a-z0-9]+). This will tell Whid to expect a task ID after “ID-” in a task name.

Save the changes.

You can find Clockify task IDs if you go to Analyze > Reports using the left sidebar. Then filter for the task that you would like to get the ID for. You can see the ID in the URL to the right of “tasks”. Take care to only filter for one task at a time and to not include the quotes in the task ID.

We plan to improve this currently somewhat clunky process in the future.

To put the “Auto Extraction for Sync Mappings” to work, track your times with names that include their corresponding Clockify task IDs.

We recommend using the “task hierarchy” feature: you can create a task name that contains the Clockify task ID and a short description of the issue, while it also describes the actual lower-level task you are working on in the context of that issue.

For example, if you are a developer and you work on a bugfix, one of your task names could look like this: ID-123abc UI glitch / Reproduce bug.

Now you want to see all your tracked times in Clockify? Then it’s time to sync them!

To open the sync overlay, first open the Main Window by right-clicking the tray icon and selecting “Main Window”. Then click the “Sync times” button in the upper right corner.

At the top, you can choose a time range for which you want to sync your entries.

If you use your Clockify task IDs as described above, you might not have to adjust anything. But if something isn’t quite right, you can make adjustments as needed.

For each task you can enter a sync ID and select the profile which includes the system you want to sync to. You can also leave those fields empty for entries you don’t want to sync.

If Whid successfully detected Clockify task IDs in your recorded entries, it will automatically fill the corresponding task ID as sync ID, and set your Clockify profile as Target.

After selecting which entries you would like to sync and filling the corresponding sync IDs, you can click on “Sync selected”.

Whid then reports the result for each synced entry: a green checkmark means the sync was successful, while a red X indicates that something went wrong.