FreshBooks

Toggl can import clients, projects and tasks from and export time entries to FreshBooks.

Details and prerequisites

Prerequisites:

• API must be enabled under your FreshBooks account settings. Open your FreshBooks account page, click "FreshBooks API" and check the "Enable API" check box.

• User emails. The account emails in FreshBooks 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.

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;

• tasks - all tasks under each project.

Toggl will export:

• all the time entries that belong to a task; time entries without a task will not be exported.

NB! If the API key belongs to a user who is not the owner of the FreshBooks account then only time entries, that belong to the user who's API key is inserted to the integration settings, will be exported.

How to use FreshBooks integration?

First, you have to set your FreshBooks integration settings. It can be done on the "Settings" -> "Integration" page. Click the "Edit" link to edit settings.

We need the account address and the authentication token to communicate with FreshBooks. The token can be found by logging into your FreshBooks account, clicking the "My Account" link in the upper-right, and then clicking the "FreshBooks API" menu item. You can also choose whether to use the task export and automatic synchronization features by checking/unchecking the check boxes. After you have entered the data, click "Save".

Please use only the Freshbooks account address (mycompany.freshbooks.com), not the entire link from the Freshbooks address bar!

Now you are ready. When you click the "Synchronize" button...

... Toggl will start importing/exporting. 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 successful sync, you'll see a picture like this: