GitHub Integration Setup

First you must connect your account in order to see tasks that are assigned to you. Also, connecting an integration allows for time to be sent back to the third-party software.

Step 1

Click on Integrations on the sidebar menu in your Hubstaff account. Make sure you have selected the correct organization on the top right corner of the page. Then choose GitHub from the list of available integrations.

Step 2

After clicking GitHub, you will be taken to where you can enter a name for the integration (this can be anything you want). Next, click the Create Integration button and you’ll be taken to GitHub so you can authorize the integration.

Step 3

If you’re not already logged into GitHub, you’ll be able to do so in this step. You’ll see your organization listed under where you can review which permissions are requested.

Click the Grant access button to grant access for your organization, then click the Authorize button to be taken back to Hubstaff to complete the integration.

Step 4

Next, you’ll be asked to select the Gitlab organization you’d like to connect to Hubstaff.

If you don’t have a GitHub organization, you won’t see anything at this step and won’t be able to complete the integration. The GitHub integration cannot connect with personal GitHub accounts.

In order for us to populate your GitHub organizations on our integration wizard drop-down and connect those with Hubstaff, you’ll need to remove third-party access restrictions in your GitHub organization settings. You can learn how to do this here.

After selecting your GitHub organization, you’ll be at the final step of the setup where you will connect your GitHub repositories with Hubstaff projects and your GitHub users with Hubstaff users. See here for more information on linking projects and users >>

After connecting your repositories/projects and users, your users will be able to track time on their assigned issues and even closed from the Hubstaff app. When they are closed, the time spent working on them will be sent back to GitHub and posted in a comment on the issue.

Tasks might not sync right away. It can take approximately 5 minutes after linking your team. Also, please keep in mind that each time you add a new project or user to your project management tool, the integration needs be refreshed in Hubstaff for those changes to take effect, then link those accordingly.Currently, when you add a new project in the project management third-party provider, you need to access the integrations page in Hubstaff > refresh the projects list > link the new project > assign team members to the Hubstaff project that’s linked to the newly added project.

Tasks can be completed outside of Hubstaff in the project management tool to have the time synced as well.

Tasks synchronized with an integration will remain in Hubstaff as a simple task if the integration is deleted.

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