Basecamp Classic

Currently Toggl only integrates with Basecamp Classic. We are working on an integration for the New Basecamp as well, though, so do keep an eye out.

Toggl can import clients, projects and to-do lists and export time entries to Basecamp.

What exactly is imported/exported?

Toggl will import:

• projects - only projects which have team members in Toggl (i.e. same email addresses), will be imported; projects will be imported with their clients;

• to-do lists - will be imported as separate projects with the format of "Project name [to-do list name]"; only those lists that have "Enable time tracking" checked, are imported;

• to-do items - will be imported as tasks under to-do list projects.

Toggl will export:

• time entries for projects;

• time entries for to-do items.

NB! To-do lists and items will only be imported if you have enabled it on Basecamp integration settings form. Same goes for export - it will only be done if you have enabled the setting.

Prerequisites

There are two things you must bear in mind when starting to integrate:

• Basecamp API has to be enabled. That can be done under your Basecamp account's "Account (Upgrade/Billing)" tab.

• User emails. The account emails in Basecamp and Toggl must be the same, otherwise project members can't be automatically added to imported projects. Also, when emails are not the same, no time will be exported for those specific team members whose account emails are different.

The process

First, you have to set your Basecamp account settings. It can be done on the Settings -> Integration page.

We need the account address and the authentication token to communicate with Basecamp. The token can be found by logging into your Basecamp account, clicking the "My Info" link in the upper-right, and then clicking "Show your tokens" at the bottom (under "Authentication tokens"). You can also choose whether to use the task export feature by checking/unchecking the check box. After you have entered the data, click "Save".

Now you are ready. When you click the "Sync now" button...

... Toggl will start. The process is asynchronous, which means you can leave the page and come back later. Here is a picture you see when the process is running:

After a sucessful sync, you'll see a picture like this:

The "See log" link will give you a detailed list of things that were done during the last sync.