Toggl time tracking integration lets you automatically post time to Toggl from your commit comments. This makes it easy to capture all the time you actually work for your clients, and ensure that you get paid for all of it. This page shows how to setup your Toggl integration to ProjectLocker.

Connect your Toggl User

First, you'll need to connect your Toggl user to ProjectLocker. To do this, you'll need your personal Toggl API token.

You can get your personal Toggl API token by logging into Toggl, clicking your name at the top right to expand the menu, then clicking the My Profile link. Your API token is at the bottom of the page.

Once you've gotten your API token from Toggl, you'll enter them into ProjectLocker by logging into ProjectLocker Portal, clicking your name in the top right to get the menu, then clicking on My Profile (this link will work if you're already logged in). On the My Profile screen, click Integration Settings and scroll down to the Toggl section.

Just enter your personal Toggl API token and save your changes.

Connect your Toggl Projects

In order to log your time against the correct Toggl projects, you'll need to link your ProjectLocker projects to the appropriate Toggl projects. You'll want to do the steps below for each ProjectLocker project you want to link to Toggl.

First, navigate to your projects list and click the name of the project you want to link to Toggl. On the project page, click the Edit button in the gray bar near the top. Scroll to the bottom of the project details page to see the Toggl link settings.

Choose the Toggl project you want to associate with this ProjectLocker project and click save changes below. 

And that's it! You're all connected!

Logging Time to Toggl

To log time to Toggl, you can simply include a brief statement about the time you spent in your commit comments. You can include the time logging in any part of your commit comments. The format is pretty simple:

took|billed|worked for|bill N hours|hrs|h|m|mins|minutes

For example, you could use any of the following to log 1 hour to Toggl:

billed 1h

worked for 60 minutes

took 1hrs

ProjectLocker will then log an hour of your time to Toggl. (If you're using Git, be sure to push to ProjectLocker so that we can process the commit message.)