Integrations

Overview

Hubstaff currently supports integrating with the 3rd party project management tools listed below and you can click on each one to see how to set each one up from your Integration page. They will allow you to sync projects and users from them to Hubstaff so that you can track time on them which will then be written back to that tool, and we also have an API that can be used to get information from the data tracked by using Hubstaff into your own applications.

Integration Write back

Some Hubstaff integrations allow for time entries to be posted directly to the site. What this means is that time tracked to tasks, tickets, issues, etc through Hubstaff is automatically synced with the third party site.

However, this is not possible with all the integrations as not all of them support time entries. Keep in mind that in order to export time back to the third-party site first the end-user must connect the integration in their Hubstaff user account settings.

Task Logging Interval

You can choose how often the integrations will write the time back in the settings on the integration page. (As shown below)
Our integration system currently has two modes of operation in regards to synchronizing time to your task system. (Either we synchronize time daily or we synchronize time when the task is closed in Hubstaff.)

Daily– The time gets synced once per day. (The data gets sent back at midnight UTC.)

Hourly – The time gets synced once an hour.

Delayed – Delays your syncing time by a day, to allow for time manual edits. (Delayed sync is currently not supported for Quickbooks.)
Complete– The time will be pushed back to the integration tool once the task is marked as Complete, please note that not all integrations support task completion. (See the bottom of this page for a list.)

Off– Will disable synchronizing task time for customers who really do not want it synced. (For customers who do not want the comments added to their tasks with the time information).

Whenever anytime is synchronized to an external system (be it a task system like Asana, a payroll system like Quickbooks, our internal team payments) we mark it as synced to that system and it becomes immutable. We do this as we cannot easily reverse the time in the remote tool and customers want the time in the two systems to match up. If we were to allow you to unmark time as immutable then the time would end up being re-synchronized to the remote system and double-logging the time.

Depending on the task system we either log the time as a comment or as native time entries (many of our other integrations support this).

Time Entries

The following integrations will allow time tracked to the tasks to be automatically logged at the site itself as time entries:

  • ActiveCollab
  • Basecamp Classic (If the account is not paid, time will get exported in the form of a comment)
  • Breeze
  • Freshdesk
  • Freshbooks (Doesn’t support task completion, will only sync daily)
  • Jira (Doesn’t support task completion, will only sync daily)
  • Liquid Planner
  • Mavenlink
  • Paymo
  • Redmine
    • When Hubstaff records time to Redmine we use the default time entry activity. If a project disallows that activity from being used, then we can not log time to that project.
    • Redmine does not support seconds in their time tracking API. So Hubstaff rounds the seconds. And this means any record that is less than 30 seconds does not get recorded in Redmine.
    • Make sure that the time logging is enabled on Redmine. You can enable /disable for each project in the Modules section of the new project form, or the Settings tab of an existing project.
  • Teamwork PM
  • Unfuddle
  • Wrike (Make sure the role of the assignee in Wrike whose time is being exported supports time tracking)

hubstaff integration time entries

An example of a time entry logged through Hubstaff (Freshdesk)

Time Entries as Comments

The following integrations do not support time entries, but they do allow time entries to be logged in the form of a comment:

  • Asana
  • Basecamp
  • Github
  • Gitlab
  • Insightly
  • Pivotal Tracker
  • Podio
  • Redbooth
  • Salesforce (opportunities are supported)
  • Trello
  • Zendesk
  • Zoho Projects

integration and task write back

An example of a time entry logged as a comment (Asana)

Task Completion

In addition to logging time entries, the Hubstaff task writes back now supports closing or completing tasks directly through the app. Your team will see a button that allows them to finish their assigned task (the language on the button will vary depending on what the project management service uses – examples are CloseCompleteSolve, etc).

2017-04-07_1518

In order for this feature to work, the user must first connect their personal Hubstaff account with their account at the third party service. If they try to complete a task before doing this, they will receive a message letting them know. The message will also provide a link where they can authenticate their account.

2017-04-07_1520

After clicking the More info button, you will be taken to where you can connect your account:

int 2

After connecting or re-authenticating, try completing the task from the Hubstaff application once more. The task will be completed and any time logged will be posted (assuming the site supports it).

Tasks can be completed outside of Hubstaff in the project management tool to have the time synced as well.
Please note that not all integrations support task completion (either because of how the API works or due to how the third party project management functions as a whole). The following don’t feature task completion in the desktop app:

  • Trello
  • FreshBooks
  • JIRA
  • Redmine

 

Basic Integration Setup

In order to see tasks that are assigned to you your project management must be connected. Also, the majority of our integrations allow for time entries to be posted directly to the project management account. What this means is that time tracked on tasks, tickets, issues, etc. through Hubstaff is automatically synced with the third party website.

As soon as you create an integration an email will get sent your way asking you to connect the integration in your user account settings. Also, the organization owner should be able to send you an email notification reminding you to connect or link your project management account.

STEP 1

Click the link on the email to be redirected to your Hubstaff account and connect your project management profile.

You may also access your Integration page by clicking on your avatar/name and then Integrations.

 

Then click the connect button to connect your project management account.

Connectintegration3

STEP 2

Depending on the type of integration, you should be able to either enter your API token (non-OAuth) or sign in to your account (Oauth) then be redirected to authorize access to Hubstaff, etc.

Non-OAuth

Authorize integration (connect)

OAuth

Authorize integration (OAuth)

You should be all set! The organization owner may have your time sent back to the third-party website daily or by completing/closing the tasks on the desktop client.

Project management tools

Those with an asterisk (*) next to them also support using our Chrome extension to track time directly in the 3rd party tool. This means that if a project or task is assigned then there will be a timer right there in the 3rd party’s site similar to what it looks like in the picture below.

 

Webhooks

The integrations below currently support webhooks which allows for almost immediate updating of things you do in the 3rd party tool such as creating a new project or task.  This doesn’t mean that all actions done in the integration will update on Hubstaff using a webhook, as each 3rd party implements them differently. As the 3rd parties add abilities and other integrations add the ability to use webhooks, we will update our side of the integration.

Asana, Basecamp v3, GitHub, Jira, Paymo, Pivotal Tracker, Podio, Trello, Wrike and partially Salesforce.

Application Programming Interface (API)

Our API can be used to develop your own interface with our software to interact with data that is gathered by the service you have with us. This means the time tracked by us could be retrieved and displayed in a way that you want to see it instead of the formats we provide. One use of this could be to create an app or site that your clients could go to and view the information related to how much time has been spent on their project(s) without you having to add them as viewers to your Hubstaff organization. You can read more about it here. If you already know about it then you can access our developer site here.

  • Was this Helpful ?
  • Yes   No
  • Was this Helpful ?
  • Yes   No